Enable webhooks to get a real time notification when something happens in PassFort.
What are webhook events?
Every webhook is triggered by an event in PassFort. Different webhooks send payloads for different events.
When a webhook is triggered by an event, it sends a payload to an endpoint you choose. The payload contains key information about what change occurred.
You can enable webhooks for the following events:
- Product status changed
- Task created
- Check completed
- Product badge changed
- Risk level changed
- Risk score changed
- Task state changed
- Collected data updated
- Form state changed
- Manual action required
- Customer request changed
- Events created
- Events updated
How to configure webhooks
To enable a webhook to send payloads:
- Go to Manage account > Webhook config.
- Select Webhooks enabled.
- 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.
- Add the endpoint you want to receive payloads to the Endpoint field.
- Select the webhook events you want to listen to from Enabled events. You can select as many as you like.
- Click Save.
Whitelisting the webhook IP address
All webhook payloads backs are sent from the same IP address:
If you're blacklisting other IP addresses, you should add this IP address to your whitelist to ensure you can receive webhooks.
Authenticating the request
When you receive a payload, you should ensure the secret in the payload matches the secret you added when you configured your webhooks.
The shared secret is sent in two places in the payload:
- As a parameter in the webhook response.
- As an HTTP Authorisation header with the bearer type.
Returning a 200 response
The webhooks have guaranteed ordering, and we'll retry delivering webhook payloads until we receive a 200 response from you.
When you receive a webhook payload, you should return a 200 response to prevent the payload from being sent again.
The webhook status queue
The webhook status queue indicates whether your webhook events are sending as expected.
- Queue: Whether the queue of payloads is Empty (and therefore the webhooks are working as expected), waiting to send a specific number of payloads, or Stalled (meaning that payloads are not being sent).
- Last processed: How long it's been since the last webhook payload was sent.
- Recent failures: If any payloads are waiting to send, this list displays the 10 most recent payloads that are waiting.
Click Refresh to clear any Recent Failures from the list.
If the webhook status queue is stalled, you can resolve it by following these steps.