Use ​Bringg webhooks to notify other enterprise systems in real time as soon as a predefined ​event​ occurs. For example, update your order management systems (OMS) when an ​order​ arrives at its ​destination​​.

Subscribing to webhooks keeps your external systems updated. This prevents the accidental overwriting of data when the system sends updates back to Bringg via API. For example, if you update a waypoint address in Bringg, the updated address is included in the next webhook from Bringg to your OMS. Then, when your OMS sends an update to Bringg – say, to add a note – your OMS sends the current data, including the updated address from Bringg.
​
​​Bringg webhooks are sent to your systems using HTTP POST methods that do not require polling (requesting data via API). To receive webhooks, you only need to register once per event. Every time that event occurs, the webhook is sent to the URLs you included in your webhook registration.
​
For a complete list of ​Bringg​ webhook events, visit our Webhooks Index.

Before You Begin

1. Confirm you have the Admin user type in Bringg.
2. Add your webhook authentication methods to Bringg.

Access Bringg's webhook settings

In Bringg, select your username from the sidebar and go to ​Settings > Platform Integrations > Webhooks > Add Webhook​​ to register for a new webhook event.

Register for a Webhook

1. Select a webhook event

Select an event in the order life cycle from the Webhook Name dropdown list.
You can find a complete list of ​available Bringg​ webhook events in our Webhooks Index.

2. Enter URLs

You can add multiple URLs to send the same webhook to multiple systems, rather than setting up independent data requests or even individual webhooks for each​.

Enter your URL in the field provided. You can create a new line in the form by selecting Add URL.

3. Add an authentication method

(Optional) Configure webhook security by selecting an ​Authentication method. Learn More.

4. Add headers

(Optional) To include static headers in your webhook payload (including static tokens for authentication), fill out the Key-Value pairs in the Headers section.

5. Refine webhook triggers

(Optional) To refine a webhook's trigger, select an event field from the Select a field to filter by dropdown list, then enter a target value.
​For example, you can create a filter to receive webhooks regarding only customers who have opted in to receive SMS notifications.

6. Customize webhook fields

(Optional) To customize the data fields included in the webhook, select ​Enable Flexible Webhook,​​ then select the relevant fields.

To view only the fields that will be included in the payload, select the checkbox next to Selected Data.

You can restore default data for a webhook by selecting Restore Default Data.

7. Save your webhook

Select Save to finalize your webhook registration.

❗️

Updating Flexible Webhooks

Adding, removing, or modifying the fields included in your flexible webhooks may change the structure of the webhook payload. Be sure to test updated webhooks and make any necessary adjustments to your recieving endpoint.