Configure Permissions for Customer Information in Your Skill

Alexa skills might require personal information from the customer in order to provide relevant information in skill responses or to complete transactions. You can configure your skill to request permission from the customer for specific information. If you have configured your skill this way, then when a user first enables your skill, Alexa asks the user to go to the Alexa app to grant permission to obtain this specific information.

Your skill must gracefully handle all of these cases:

  • The user grants permission in the Alexa app.
  • The user ignores the request and does not go to the Alexa app.
  • The user goes to the Alexa app and refuses permission for the skill to obtain this information.

If this customer information is required in order to use the skill, and the customer does not agree to provide it, your skill must exit gracefully in order to provide a good customer experience.

How to configure your skill to request permissions for customer information

Open your skill in the developer console. Go to the Build page, and scroll down to Permissions on the lower left. Toggle the permission on for the permission that corresponds to the information your skill requires.

Currently, the available permissions for custom skills include:

  • Device Address
  • Customer Name
  • Customer Email Address
  • Customer Phone Number
  • Lists Write
  • Lists Read
  • Reminders
  • Location Services
  • Skills Personalization

To avoid gathering unneeded customer information, and to facilitate a better customer experience, only toggle a permission on if your skill will use that information to improve its responses.

You must use any personal information you request only as permitted by the user and in accordance with your privacy notice and applicable law.

Was this page helpful?

Last updated: Dec 29, 2022