INTEGRATION
At a glance
Events
Six event types
Delivery
HTTPS endpoint you control
Security
Signed with HMAC SHA256
Retries
Up to three if the connection is refused
OVERVIEW
Events you can receive
asset.status-updated
An asset’s blocklist status changed to blocked, allowed or unknown.
asset.status-escalated
A threat was escalated to you for review. The event includes a review link.
asset.escalation-resolved
An escalated threat left your review: approved, rejected, watchlisted or returned to ChainPatrol.
organization.threat-detection-added
A new suspected threat was flagged for your organization.
audit-log.created
An admin action happened, such as a brand update, a member change or API key creation.
debug.test
A test event you can send from the dashboard.
SETUP
How to set it up
Set up a webhook in four steps
Setup
1
Open Webhooks
In your dashboard, go to Developer, then Webhooks.
2
Add an endpoint
Enter an HTTPS URL and choose the events you want.
3
Save the secret
The secret is shown once, when you create the webhook.
4
Verify each request
Check the X-ChainPatrol-Signature header, an HMAC SHA256 of the raw body made with your secret.
GOOD TO KNOW
What to know
No takedown events
There are no webhooks for takedown status changes or report events. Use the API to list takedowns and their status.
Retries
If your endpoint refuses the connection, delivery is retried up to three times.
Frequently asked questions