Custom Headers

You can configure custom headers to provide additional information to payloads from an integration.

BigPanda allows you to create Custom Headers to specify customized information with your integration. If you have not been granted Administrator access to the integration system, you can modify the integration through custom headers.



Custom headers take priority over the fields you configure on the Integration page.

Create Custom Headers

  1. In BigPanda, navigate to Integrations.
  2. Select the integration system from the Integrations list.
  3. In the right pane, select Review Instructions.
  4. Under Configure the Webhook, create your Custom Headers.

  1. Select Add a custom HTTP header.
  2. In Header key, enter the prefix x-bp-field- followed by the field you wish to modify.
  3. Enter the Header value, which is the integration field name.
  4. Select Configure Webhook.

Here are some examples of custom headers:

Custom HeaderDescription
x-bp-config-updateFieldsYou can add the integration fields to be updated when a BigPanda incident is updated. You can include multiple fields in a comma-separated value format.
x-bp-mapping-fieldsYou can map fields from BigPanda into the integration in a comma-separated value format.
Place the BigPanda field on the left side of the assignment and the Integration field on the right side:
x-bp-field-{SERVICENOW_FIELD}(Optional for ServiceNow)
You can add a ServiceNow field that you wish to modify. Provide the field name in the braced SERVICENOW_FIELD.

For example, if you wish to assign a particular Assignment Group for incidents you can create a Custom Header. If you define the Assignment group as “IT Security” in a custom header this overrides the Assignment group definition on the Configuration page.