Set up the Amazon Alexa spoke

task australia Updated Mar 12, 2026 3 min read ssetup-alexa.md
Raw file servicenow.com

Integrate the ServiceNow instance and Amazon Alexa account by creating a custom OAuth application in Amazon Alexa to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the Amazon Alexa spoke.
  • Role required: admin

Create a security profile

Create and register a security profile through the Developer Console to use Login with Amazon on your ServiceNow instance.

Before you begin

Role required: admin.

Procedure

  1. Log in to Amazon Developer Portal with admin credentials.

  2. Create a security profile.

    For information about creating a security profile, see Create an LwA Security Profile in Amazon Developer Documentation.

  3. Copy and record the values of Client ID and Client Secret for later use.

  4. Configure the security profile and specify these values in Web Settings:

    Field Value
    Allowed Origins ServiceNow instance URL.
    Allowed Return URLs ServiceNow instance redirect URL in this format: https://<Instance-Name>.com/oauth_redirect.do

    For more information about configuring the security policy, see Add your Website to your Security Profile in Amazon Developer Documentation.

Configure a connection for the Amazon Alexa spoke

Add and configure a Amazon Alexa connection to authenticate ServiceNow requests in the Amazon Alexa spoke.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > Process Automation > Workflow Studio.

  2. Click the Integrations tab.

  3. Under Connections, the Outbound connections are displayed by default.

  4. Locate the AmazonAlexa connection alias and click View Details.

    • To configure the default connection and credential alias record that is shipped along with the Amazon Alexa spoke, click View Details.

      [Omitted image "amazon-alexa-connection.png"] Alt text: AmazonAlexa connection alias with the View Details button highlighted.

    • To manage more than one Amazon Alexa spoke connection record, create a new child alias record by clicking Add Connection. For more information about using multiple connections, see Supporting multiple connections. If you are configuring the spoke for the first time, click Configure. Otherwise, click Edit.

    [Omitted image "amazon-alexa-connection-conf.png"] Alt text: Connections panel for the AmazonAlexa alias with the Configure button highlighted.

  5. On the Configure Connection form, fill in the fields.

    Field Description
    Connection Information
    Connection Name Name to uniquely identify the record. By default, the name is AmazonAlexa.
    Connection URL Base URL to connect to Amazon Alexa. Enter: https://api.amazonalexa.com
    API Version Required API version of Amazon Alexa. Enter v1.
    Credential Information
    OAuth Entity Name Name to identify the OAuth entity record. For example, Amazon Alexa OAuth.
    OAuth Client ID Client ID created during the configuration of the security profile.
    OAuth Client Secret Client Secret created during the configuration of the security profile.
    OAuth Redirect URL OAuth callback endpoint in this format: https://<instance>.service-now.com/oauth_redirect.do. Replace <instance> with the ServiceNow instance name.

    [Omitted image "amazon-alexa-conf-temp.png"] Alt text: Configure Connection form for the Amazon Alexa spoke with the connection and credential fields.

  6. Click Save and Get OAuth Token.

Result

The Amazon Alexa spoke is set up and integrated with the ServiceNow instance.

Setup webhook for the Amazon Alexa spoke

Authenticate the inbound requests from Amazon Alexa account to your ServiceNow instance by creating a webhook registry.

Before you begin

Role required: admin.

Procedure

  1. In the filter navigator, enter token_verification.list.

    Records in the Token Verifications [token_verification] table are displayed.

  2. Click New.

  3. On the form, fill these values.

    Field Description
    Name Name to identify the token record. For example, Alexa token.
    Description Brief description of the token.
    Token Value of token. This value is encrypted before it is used.

  4. Click Submit.

  5. Navigate to Alexa Webhooks > Alexa Webhook Registries.

  6. Click New.

  7. On the form, fill these values.

    Field Description
    Name Name to identify the webhook registry record. For example, Alexa token.
    Description Brief description of the webhook registry record.
    Token Token you have created. For example, Alexa token.
    Path Scripted REST endpoint. A default endpoint is available. You can change the default value as per your requirement.

  8. Right-click the form header and click Save.

  9. Click Callback URL.

    Webhook Callback URL is displayed in the confirmation message. Copy and record this value.

  10. Log in to AWS Management Console.

  11. In the AWS Lambda function, specify the Webhook Callback URL and save the changes.

    [Omitted image "alexa-url.png"] Alt text: Webhook Callback URL

  12. Log in to Alexa Developer Console.

  13. Navigate to Build > CUSTOM > Endpoint and specify ARN of the AWS Lambda function you had configured.

    [Omitted image "alexa-lambda-arn.png"] Alt text: AWS Lambda ARN

Search documentation
Search document titles and file paths on the australia branch