Webhooks Used in the B2B Ninja API

What are they? And how to use B2B Ninja's webhooks effectively. This is advanced level document geared towards developers.

Micah Thomas avatar
Written by Micah Thomas
Updated over a week ago

Webhooks (also called a web callback or HTTP Push API) are part of most advanced API systems, and it allow you to connect two systems with the ability to update them in real time. Compared to polling an API on an interval, webhook allows an application to push the data to your system as soon as an event takes place. This has a couple of benefits, it provides a more responsive experience while also being more efficient.

To use webhooks, your B2B Ninja account will need to have API Access enabled. This feature is included in our Enterprise plan. Please contact us for a quote if you would like API access on another plan.

Webhook events/triggers inside B2B Ninja

  1. Quote - Created

  2. Quote - Sent

  3. Quote - Email Added

  4. Quote - Tagged

  5. Quote - Tag Removed

  6. Quote - Order Placed

Configuring a webhook

It's easy to setup a webhook within B2B Ninja. Just paste in the URL that you want B2B Ninja to send a HTTP POST request to when the event happens. The only requirement is that the URL be secured and start with https://

  1. Go to the API settings tab and scroll to the webhooks section

  2. Enable the webhook event that you want to use by clicking the checkbox

  3. Paste in the URL that you want B2B Ninja to send the POST request to

  4. Click Apply Changes button at the top right

Securing the webhook [recommended]

You can secure the webhook with a secret that only you and B2B Ninja share. If set, we will pass this secret to your system with every webhook as a request header. The header key will be qn-secret and the value will be the secret you set. Your server can filter out requests that don't have the secret set.

Notes

Since webhooks happen when an action takes place, if your service is not available to handle the request or has an error while processing the request, data loss may occur. B2B Ninja does not have a retry on failure system, so you will need to ensure that the connection is working so that data does not go out of sync.

We also have Zapier integration in BETA with triggers that correspond to webhooks that allow you to integrate with other systems easily. If you would like to use this, please contact support to give you access.

Did this answer your question?