Webhooks
Webhooks allow your application to receive real-time notifications when events occur in Signstack. Configure webhook endpoints to be notified about workflow lifecycle events (started, completed, failed), step events (started, completed), participant events (task assigned, signing completed, declined), and envelope events (sent, completed, voided).
Each webhook configuration specifies a URL endpoint and the event types to subscribe to. When an event occurs, Signstack sends an HTTP POST request to your endpoint with a signed payload containing the event details. Use the webhook secret to verify the authenticity of incoming requests.
Signstack automatically retries failed deliveries with exponential backoff. You can monitor delivery status and review past delivery attempts through the API. Webhook events are delivered at least once, so implement idempotency in your handlers using the eventId field.
- get/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs
- post/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs
- get/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs/{id}
- put/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs/{id}
- delete/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs/{id}
- get/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/configs/{id}/secret
- get/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/deliveries
- get/v1/orgs/{orgId}/ns/{namespaceKey}/webhooks/deliveries/{id}
