Set up a bi-directional webhook for the Aha! spoke

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Configure a webhook to subscribe to events in the Aha! account with a ServiceNow callback URL.

    Avant de commencer

    Role required: admin

    Create a Token

    Create a token that will be embedded in the callback URL to Aha!.

    Avant de commencer

    Role required: admin

    Procédure

    1. In the navigation filter, enter token_verification.list.
      The system displays records in the Token Verifications table.
    2. Select New.
    3. On the form, fill the fields.
      Tableau 1. Token Verification form
      Field Description
      Name Option to provide a unique name to identify the token. For example, Aha! Callback URL token.
      Description Option to provide a description of the token.
      Token Option to provide a unique authentication token. This token is encrypted and embedded in the URL.
    4. Select Submit.

    Create an Aha! Webhook in ServiceNow

    Register an Aha! webhook in to notify the app when certain events occur in Aha!.

    Avant de commencer

    Role required: admin

    Procédure

    1. Navigate to All > Aha! Spoke > Webhook > Webhook Registries.
    2. Select New.
    3. Fill the form.
      Tableau 2. Aha! Webhook Registry
      Field Description
      Name Option to uniquely identify the record.
      Path Option to provide the webhook path. Enter api/sn_aha_spoke/aha_webhook.
      Token Option to specify the token you had created. See Create a Token.
    4. Right-click the form header and click Save.
    5. Select Callback URL.
      The system displays the webhook callback URL.
    6. Copy and record the webhook callback URL.

    Add callback URL to Aha!

    Register the webhook callback URL to the Aha! account.

    Avant de commencer

    Role required: admin

    Procédure

    1. Log in to your Aha! account as an admin.
    2. Navigate to Settings > Account.
    3. Create an activity webhook by clicking + beside Integrations.
    4. Click + Activity webhook in the Activity webhook tile.
    5. On the form, fill these values.
      Field Description
      Hook URL Webhook callback URL you had copied from the ServiceNow instance.
      Selected Activities Activities or events for which you want to subscribe.
    6. Click Add activity.

    Set webhook routing policy

    Create a webhook routing policy and subflow as per your requirement.

    Avant de commencer

    Role required: admin

    Pourquoi et quand exécuter cette tâche

    The default routing policy in the Aha Webhook Decision Policy module triggers the Process Aha webhooks subflow and notifies the ServiceNow app when certain events occur in Aha!. See Aha! Spoke for information about the fields that the default routing policy and subflows support. To use any other fields in your custom subflow and customize conditions in the routing policy, perform these steps.

    Procédure

    1. Navigate to All > Aha! Spoke > Webhook > Webhook Routing Policies.
    2. Select New.
    3. Fill the form.
      Tableau 3. Decision form
      Field Description
      Label Unique label to identify the routing policy.
      Default answer Option to specify if this is the default answer. The default answer is applicable when the conditions are not met.
      Condition Conditions to be met when the required events occur in Aha!.
      Answer Subflow that must be triggered when the specified conditions are met.
      1. Click the lookup icon (Lookup icon).
      2. Select the required subflow from the Document list.
        Remarque :
        Ensure that the Table name is Flow [sys_hub_flow].
    4. Select Submit.