---
sourceDocument: Yokohama Data and Automation
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Data and Automation

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up a bi-directional webhook for the Box spoke

# Set up a bi-directional webhook for the Box spoke {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

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.
{#setup-webhook-box-spoke__ul_n5j_dd5_fpb}

## Add an endpoint URL in a Box account {#ariaid-title2}

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](https://app.box.com/developers/console).
2. Create an app according to your requirements.  
   For more information about app creation, see [Create an OAuth application](https://www.servicenow.com/docs/1PGfcPOKV5dPQsXobEJA6g#configure-box-account "Create a custom OAuth application from your Box account to enable OAuth 2.0 authentication with the Box spoke.").
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.
   {#add-endpoint-url-box__substeps_ctg_xm3_tzb}
4. Navigate to the Webhooks section.
5. To create a V1 webhook, select Create Webhook and select V1.
   1. Complete the fields.  
      {#add-endpoint-url-box__table_ngv_xcj_tzb__entry__2}

      | Field | Value |
      |-|-|
      | Name | <kbd class="ph userinput">Update Chatter feed</kbd> |
      | Description | <kbd class="ph userinput">Automatically updates your Chatter feed when a change occurs</kbd> |
      | Event Type | Enable at least one option |
      | Endpoint URL | The endpoint URL of the ServiceNow instance in the following format: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint</kbd> |
      | Payload format | Select the appropriate payload data format |
      | Callback Parameters | Select add callback parameter to configure any GET or POST methods |
      [ ]

      {#add-endpoint-url-box__table_ngv_xcj_tzb}
   2. Select Save Webhoook.
   {#add-endpoint-url-box__substeps_nk2_xcj_tzb}
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](https://www.servicenow.com/docs/1PGfcPOKV5dPQsXobEJA6g#configure-box-account "Create a custom OAuth application from your Box account to enable OAuth 2.0 authentication with the Box spoke.").
   1. For the URL Address, enter the endpoint URL of the ServiceNow instance in the following format: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint</kbd>.
   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 {#ariaid-title3}

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 AllBoxBox Webhook Registry.
2. Select New.
3. Fill in the fields.  
   {#register-box-webhook__table_bny_tg5_fpb__entry__2}

   | 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](https://www.servicenow.com/docs/fUtZP71upwe2fya1jaI~0g#add-endpoint-url-box "Specify an endpoint URL in your Box account to create a webhook for Box spoke.") |
   | 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](https://www.servicenow.com/docs/fUtZP71upwe2fya1jaI~0g#add-endpoint-url-box "Specify an endpoint URL in your Box account to create a webhook for Box spoke.") |
   | Description | Optionally, describe the purpose of the record |
   [ ]

   {#register-box-webhook__table_bny_tg5_fpb}
4. To confirm, select Submit.

### Result

The Box webhook is registered in your ServiceNow instance.

*[\>]: and then