Create a new webhook
Create a new webhook subscription for your workspace.
Required Fields:
webhookUrl- URL that will receive POST requests when events occureventTriggers- Array of event types to subscribe to
Optional Fields:
secret- Signing key for this endpoint. A 32-byte key is generated when omittedenabled- Whether the webhook is active (default: true)
Delivery: every request carries X-Sajn-Signature: t=<unix seconds>,v1=<hex hmac-sha256 over "<t>.<raw body>"> and X-Sajn-Delivery, a delivery id that stays the same across the retries of one event. Failed deliveries (5xx, 408, 429, network error) are retried up to 5 times with exponential backoff capped at 300 s, so receivers must dedupe on X-Sajn-Delivery.
Available Event Types:
- Document:
DOCUMENT_CREATED,DOCUMENT_SENT,DOCUMENT_OPENED,DOCUMENT_SIGNED,DOCUMENT_COMPLETED,DOCUMENT_REJECTED,DOCUMENT_WITHDRAWN,DOCUMENT_ARCHIVE_UPLOADED - ID Check:
ID_CREATED,ID_SENT,ID_OPENED,ID_VERIFIED,ID_FAILED,ID_CANCELED - Contact:
CONTACT_CREATED,CONTACT_UPDATED,CONTACT_DELETED - Form:
FORM_SUBMITTED, with the same fields asGET /api/v1/forms/:id/submissions/:submissionId
Plan Requirement: Requires SOLO plan or higher.
Authorizations
Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Headers
Bearer token for API authentication
Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.
255Body
Body
Create webhook request
URL that will receive webhook events
List of event types to subscribe to
1DOCUMENT_CREATED, DOCUMENT_SENT, DOCUMENT_SIGNED, DOCUMENT_COMPLETED, DOCUMENT_REJECTED, DOCUMENT_EXPIRED, DOCUMENT_WITHDRAWN, DOCUMENT_MODIFIED, DOCUMENT_DELETED, DOCUMENT_RESTORED, DOCUMENT_ARCHIVED, DOCUMENT_UNARCHIVED, DOCUMENT_EXPIRATION_EXTENDED, DOCUMENT_PARTY_SENT, DOCUMENT_PARTY_DELIVERY_FAILED, DOCUMENT_PARTY_OPENED, DOCUMENT_PARTY_READ, DOCUMENT_PARTY_SIGNED, DOCUMENT_PARTY_REJECTED, DOCUMENT_PARTY_DELEGATED, DOCUMENT_PARTY_AUTH_FAILED, DOCUMENT_PARTY_ADDED, DOCUMENT_PARTY_REMOVED, DOCUMENT_REMINDER_AUTOMATIC, DOCUMENT_REMINDER_MANUAL, DOCUMENT_ARCHIVE_UPLOADED, ID_CREATED, ID_SENT, ID_OPENED, ID_VERIFIED, ID_FAILED, ID_CANCELED, CONTACT_CREATED, CONTACT_UPDATED, CONTACT_DELETED, TEMPLATE_CREATED, TEMPLATE_UPDATED, TEMPLATE_DELETED, TEMPLATE_RESTORED, FORM_SUBMITTED, WORKSPACE_CREATED, MEMBER_ADDED, LOGIN_COMPLETED, LOGIN_FAILED, SECURITY_DOCUMENT_DOWNLOADED, SECURITY_DOCUMENTS_EXPORTED, SECURITY_SIGNATURE_IDENTITY_ACCESSED, SECURITY_WORKSPACE_MEMBER_REMOVED, SECURITY_WORKSPACE_MEMBER_ROLE_CHANGED, SECURITY_WORKSPACE_ROLE_UPDATED, SECURITY_WORKSPACE_RETENTION_UPDATED Whether this webhook is active (default: true)
Signing key for this endpoint. A 32-byte key is generated when omitted; deliveries are signed with it in X-Sajn-Signature
Email address that will be notified if webhook delivery fails
^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$Response
Webhook response
Webhook response
Unique webhook identifier
URL that receives webhook events
Signing key for this endpoint. Deliveries carry X-Sajn-Signature: t=,v1=<hex hmac-sha256 over ".">
Whether this webhook is active
Email address that receives a notification if webhook delivery fails
List of event types this webhook subscribes to
Date and time when webhook was created
Date and time when webhook was last updated

