Set up a bi-directional webhook for the Box spoke

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura

    • Configure a webhook to subscribe to Box with a ServiceNow callback URL.

    Antes de Iniciar

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

    Add an endpoint URL in a Box account

    Specify an endpoint URL in your Box account to create a webhook for Box spoke.

    Antes de Iniciar

    Role required: admin

    Procedimento

    1. Log in to the Box developer's console.
    2. Create an app according to your requirements.

      For more information about app creation, see Create an OAuth application.

    3. Generate a primary Key and secondary Key for your app and record the values.
      1. In My Apps, select the application.
        You are in your application's General Settings.
      2. Navigate to Webhooks.
      3. Select Manage Signature Keys.
      4. In the Primary Key section, select Generate Key.
      5. In the Secondary Key section, select Generate Key.
      6. Copy and save both key values for later.
    4. Navigate to the Webhooks section.
    5. To create a V1 webhook, select Create Webhook and select V1.
      1. Complete the fields.

        Field

        Value

        Name

        Update Chatter feed

        Description

        Automatically updates your Chatter feed when a change occurs

        Event Type

        		 Enable at least one option

        Endpoint URL

        The endpoint URL of the ServiceNow instance in the following format: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint

        Payload format

        Select the appropriate payload data format

        Callback Parameters

        Select add callback parameter to configure any GET or POST methods
      2. Select Save Webhoook.
    6. To create a V2 webhook, select Create Webhook and select V2.
      Nota:
      To create a V2 webhook, you must enable Manage webhooks in the Configuration settings. For more information, see Create an OAuth application.
      1. For the URL Address, enter the endpoint URL of the ServiceNow instance in the following format: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint.
      2. For The type of item to trigger a webhook, select Choose an item.
      3. Select the webhook configured file or folders.
      4. To confirm select Choose.
        A list of configured webhook triggers display in the Create a Webhook page.
      5. Enable the appropriate GET and POST methods for each trigger.
      6. To confirm, select Create Webhook.

    Resultado

    The endpoint URL is added in your Box account. You can create webhook registries and subflows according to your requirements.

    Register a Box webhook in ServiceNow

    Create a Box webhook registry in ServiceNow to notify the ServiceNow app when certain events occur in your Box account.

    Antes de Iniciar

    Role required: admin.

    Procedimento

    1. In your ServiceNow, navigate to All > Box > Box Webhook Registry.
    2. Select New.
    3. Fill in the fields.

      Field

      Value

      Name

      Optionally, name the webhook registry

      Trigger Name

      Select the appropriate event trigger

      Primary Key

      The primary key that you generated in Add an endpoint URL in a Box account

      Flow Name

      The flow that occurs when the event triggers

      Secondary Key

      The secondary key that you generated in Add an endpoint URL in a Box account

      Description

      Optionally, describe the purpose of the record
    4. To confirm, select Submit.

    Resultado

    The Box webhook is registered in your ServiceNow instance.