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

Before you begin

  • 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.

Before you begin

Role required: admin

Procedure

  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.
    Note: 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.

Result

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.

Before you begin

Role required: admin.

Procedure

  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.

Result

The Box webhook is registered in your ServiceNow instance.