Skip to main content
Webhooks are available on Pro, Business, and Enterprise plans. Endpoint limits vary by tier.

Authentication

Webhook management endpoints are dashboard-session authenticated (cookie-based) — API keys are not accepted on /api/v1/org/* routes. Callers must have Admin role or above within the organization.

List webhook endpoints

Returns all configured webhook endpoints for the organization, sorted by creation date (newest first). Response

Create a webhook endpoint

Request body
Supported event types Response201 Created
The secret field is returned only at creation time. Store it immediately — it cannot be retrieved again. Use it to verify the X-Grantiva-Signature header on incoming deliveries.

Update a webhook endpoint

Toggle the endpoint on/off, change subscribed events, or update the description. All fields are optional. Request body
Response200 OK Returns the updated WebhookResponse object (same shape as list response, without secret).

Delete a webhook endpoint

Permanently removes the webhook endpoint. In-flight deliveries are not retried after deletion. Response204 No Content

Signature verification

Every delivery includes an X-Grantiva-Signature header containing an HMAC-SHA256 signature of the raw request body, signed with your webhook’s secret. Verify the signature before processing any payload:
For Node.js, Python, and Go examples see Webhooks Concepts.

See also