Application authorization - Prime Video Tech Docs

Application authorization

Last updated 2024-08-23

After creating your security profile, you must authorize the application.

This process safelists and authorizes your application to use Prime Video Slate on behalf of the user who authorizes the application. The application is limited to the scope selected when authorizing it. This allows the application to only use Slate features that are both included within the authorized scope and within the set of permissions the authorizing user is granted. Changing the scope requires repeating the following process; however, changing the permissions of the authorizing user does NOT require repeating that process.

For production purposes, we recommend creating a dedicated Slate account for your application to use. First, make sure that an email address similar to report_downloader@example.com exists for your company’s domain. Then, create a Slate account using that email address. The application’s dedicated Slate account should be granted the minimal permissions required to download reports (such as Reports: View Only).

Note: Sign in to Slate before completing the following procedures.

Application safelisting

The following steps safelist your application to access your Slate accounts.

  1. In your Slate account, click the Account settings dropdown in the top-right corner of the window, and then click Applications.
  2. Click Add Application.
  3. In the Client ID box, enter your Client ID, select the Reporting check box, and then click Add application.

Generate authorization code

The authorization code is a one-time code created using your web browser. The code is used only the first time your application requests a token (unless the authorizing user revokes consent).

To get the authorization code, you’ll create a specific URL to use in your web browser. To complete this step, you’ll need the following:

  • The application’s security profile client_id
  • The application’s registered redirect_url
  • Response type from the authorizer—this should be code
  • Scope to authorize: videocentral::reports:read

The URL uses the following format:

https://www.amazon.com/ap/oa?client_id=[YOUR_CLIENT_ID]&redirect_uri=[YOUR_REDIRECT_URI]&scope=videocentral::reports:read&response_type=code

  1. Replace [YOUR_CLIENT_ID] and [YOUR_REDIRECT_ID] (including the brackets) with your specific values from above, and then open the URL in your web browser.
  2. When prompted to sign in, use the application’s dedicated Slate user account (for example, report_downloader@example.com.
  3. On the authorization screen, click Allow.
    You should be redirected to the redirect_uri that you provided. In the browser address bar, the query string will have a suffix containing both the authorization code and the scope.

The authorization code will appear within the query string.

For example: ?code=ANQCZiBAPweTtvCiAaaa&scope=videocentral::reports:read

The code listed is the application authorization code. In the example above, ANQCZiBAPweTtvCiAaaa is the code.

Note: If you remove the authorizing user’s permissions to use reports, then the application will also have its permission to use reports revoked.

Can’t find what you’re looking for?

Contact us


Internal Server error! Please try again
Your session has expired

Please sign in to continue

Sign In
edit