Webhooks
Receive signed notifications when Matter, Turn, execution, and approval events occur in Your Company.
Webhooks send an HTTP POST request when activity occurs in your Workspace. Create a subscription for only the event types your integration needs.
Common events include:
matter.turn_completedwhen either side returns a completed Turnmatter.executedwhen an Executed Copy is storedapproval.requestedwhen an Approval Chain reaches a new stageapproval.decidedwhen an approver records a decision
Delivery and retries
Return a success status within five seconds after validating and storing the event. Process slow work asynchronously. If delivery fails or times out, Your Company retries after 1 minute, 5 minutes, 30 minutes, 2 hours, and 12 hours. A subscription is paused after 20 consecutive failed deliveries.
Events can arrive more than once and, during retries, out of order. Use the event id for deduplication and the created_at time for ordering within one resource.
Verify a signature
Each request includes YourCompany-Webhook-Id, YourCompany-Webhook-Timestamp, and YourCompany-Webhook-Signature headers. Build the signed content from the identifier, timestamp, and exact request body, separated by periods. Compute an HMAC-SHA256 digest with the subscription secret and compare it with the supplied signature using a constant-time comparison.
Return success for an event you have already processed. Use the webhook subscription endpoints to create and manage destinations.