Steps to Implement Account Linking

When you implement account linking, your skill can access the user's information in your service. Complete the following steps to implement account linking for your service.

Before you start

To learn how account linking works with your skill type, see one of the following references:

Steps to implement account linking

Complete the following steps to add account linking to your app or web page.

  1. Configure account linking
  2. Implement the authorization flow
  3. Use access tokens in your code
  4. View metrics (optional)

Step 1: Configure account linking

To configure your authorization provider details, see Configure Account Linking in Your Skill. Amazon recommends that you implement the authorization code grant flow.

Step 2: Implement the authorization flow

After you configure account linking, implement the OAuth 2.0 authorization flow to exchange credentials between your service and Alexa. Alexa supports three authorization flows for the authorization code grant type: standard, app-to-app starting from your app, and app-to-app starting from the Alexa app. For details about implementing these flows, see Implement the Authorization Flow. If you configured your custom skill with the implicit grant type, you can skip this step.

Step 3: Use access tokens in your code

After successful account linking, Alexa includes an access token in each request. Update your code to use the access token to retrieve user information from your resource server. For details, see Use Access Tokens in Your Code.

Step 4: View metrics (optional)

When your skill is live, you can see account linking metrics, such as the total number of account linking initiations, in the developer console in the Analytics section.

Was this page helpful?

Last updated: Jul 14, 2026