An Amazon API Key is required for all Amazon apps.

Requirements:

An Amazon app.
An Amazon Developer account account.
A OneSignal Account, if you do not already have one.

Step 1. Create A Security Profile

Click on the Device Messaging tab and click Create a New Security Profile.

Give your Security Profile the required name and description, then click Save.

You should get a series of success messages. Next, click View Security Profile to continue.

You will then see a settings page that lists your Client ID and Client Secret. Leave this page open, as you will need this information in Step 2.

Step 2. Configure Your OneSignal App's Amazon Platform Settings

In the OneSignal dashboard, select your app from the All Apps page, then go to Settings. Under Native App Platforms, click Amazon Fire.

Paste your Client ID and Client Secret into the fields and click Save.

Step 3. Creating An Amazon API Key

The following steps are required to test push notifications before publishing your app to the Amazon App Store.

Go back to the Amazon Security Profile page for your app, and select the Android/Kindle Settings tab.

Enter any name you like for the API Key Name.

Enter your Android package name. NOTE: the package name is case sensitive.

Enter the MD5 signature of your Android Keystore you used to sign the APK file with. See Amazon's instructions to get this value.

We recommend not using the default debugging keystore, but if you do, make sure you redo this again with your Production keystore, or let Amazon sign your app for you.

When you're done, click Generate New Key.

Copy the Key shown in the results and save it into a new file named api_key.txt.

When your app is built, this file needs to be located in /assets/ in the root of your APK.

More details on the placement of this file can be found in our Amazon SDK Setup documentation.

Done! You now have a key to send push notifications from your app. 🥳

Next, install the OneSignal SDK in your app. If you need help, we have a few SDK-specific guides:

Amazon SDK Setup