Skip to main content

How to configure webhooks

To enable a webhook to send payloads:

  1. Go to Manage account > Webhook config.

  2. Select Webhooks enabled.

  3. If you would like webhooks to be sent in batches, select Enable batching. We recommend enabling batching.

  4. Add your Secret to the Shared secret field. Ensure that your integration checks the Secret when webhook payloads are received. This will make sure a malicious third party can't intercept the payload and provide you with false information.

  5. Add the endpoint you want to receive payloads to the Endpoint field.

  6. Select the webhook events you want to listen to from Enabled events. You can select as many as you like.

  7. Select Save.

Note that webhooks cannot be sent directly to a Salesforce endpoint because Salesforce interprets our Authorization header as an attempt to authorize requests in Salesforce. Any requests directly to a Salesforce endpoint will be rejected with a 401 Unauthorized Error. To work around this, send requests through an intermediary or use a webhook-altering tool.

Batching

When batching is enabled, multiple webhooks are delivered in a single request.

Webhook messages are added to a queue, and Passfort delivers the first 100 messages in the queue approximately every 0-10 seconds.

We recommend enabling batching - particularly for high-volume customers - because it's the fastest option. Without batching, webhooks are sent one at a time, in the order they were triggered.

Additional information