Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get started
Connect with Matter
Alexa Connect Kit
Add-ons
Certify
Resources
Skip to main content
Now that your app has the user’s Amazon access token, your backend server can call the Alexa Skill Enablement API to enable the skill. As part of this step, the Alexa service sends an access token request to your token server for access to the user’s resources in your system.

Enable the skill and complete account linking

Your backend app calls the Alexa Skill Enablement API endpoint with the following parameters:
  • User’s Amazon access token in the Authorization header
  • Authorization code for the user’s account in your service, obtained from your authorization server.
  • Redirect URI for your app
  • Authorization type (AUTH_CODE)
As part of the API, the Alexa service sends an access token request with the your authorization code to your token server URL. The access token that Alexa receives in the response allows your skill to access the user’s resources in your system.

HTTP Request

Make a request to the Enable skill and account link enablement resource. Set the API endpoint based on where the user’s account is registered.

HTTP response

On success, the Alexa Skill Enablement API returns HTTP 201 Created, indicating that the skill is enabled and the accounts are linked.
For possible errors and the associated message to show the user, see Errors when calling the Alexa Skill Enablement API. If the user deletes your service, you can disable the skill and unlink the account for the user. To do so, make a Disable skill and unlink account request to the Alexa Skill Enablement API.

Example skill enablement and linking

In this example, the app enables the skill and completes account linking.

Errors

If an error occurs when your app calls the Alexa Skill Enablement API to enable and link the user’s account, the API responds with a status code that says why the request failed. Otherwise, the API responds with an HTTP 2XX status code. For details about why the skill activation request failed, check the message parameter of the JSON response.
HTTPS status codeMessage to show to userPossible causes
400 Bad RequestWe are experiencing a problem connecting with Alexa to link your account. Please try again later.
  • Missing skill_id, stage, accountLinkingRequest.authCode, accountLinkingRequest.redirectUri, and/or accountLinkingRequest.Type
  • Error requesting your app’s access and refresh token pair from your app’s token server
403 ForbiddenWe are experiencing a problem connecting with Alexa to link your account. Please try again later.
  • The Amazon access token is invalid
  • The Amazon access token doesn’t have the user’s consent to enable the skill
  • The Amazon access token doesn’t belong to the skill_id provided in the request
  • The user isn’t entitled to enable the skill with the specified skill_id provided in the request
404 Not FoundWe are experiencing a problem connecting with Alexa to link your account. Please try again later.
  • Invalid skill_id and/or stage
500 Server ErrorSorry, Alexa encountered an unexpected error while trying to link your account. Please try again.
  • Unexpected server error
  • Problem linking accounts with your app’s OAuth server
Last modified on October 4, 2026