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)
HTTP Request
Make a request to the Enable skill and account linkenablement 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.Disable the skill and unlink the accounts
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 HTTP2XX status code. For details about why the skill activation request failed, check the message parameter of the JSON response.
| HTTPS status code | Message to show to user | Possible causes |
|---|---|---|
| 400 Bad Request | We are experiencing a problem connecting with Alexa to link your account. Please try again later. |
|
| 403 Forbidden | We are experiencing a problem connecting with Alexa to link your account. Please try again later. |
|
| 404 Not Found | We are experiencing a problem connecting with Alexa to link your account. Please try again later. |
|
| 500 Server Error | Sorry, Alexa encountered an unexpected error while trying to link your account. Please try again. |
|

