Set up a bi-directional webhook for the Box spoke

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.

2.  Select **Save Webhoook**.

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

1. To confirm, select Submit.

Result

The Box webhook is registered in your ServiceNow instance.