Skip to main content

Webhooks

A webhook is an HTTP callback we send to your URL when something happens in a signing flow.


What a webhook is​

A webhook is a real-time HTTP callback for an event you care about. You get the update when it happens, instead of polling for it.


A typical use​

Subscription billing

If a subscription should start after the document is signed, subscribe to agreement.lifecycle.finalized. When that event arrives, you can continue the customer's signup.


Security​

See Webhook Security for how to check that a request came from us.

Verify the signature

Follow the Webhook Security guidelines before you trust a webhook payload.


Delivery​

We retry failed deliveries, and you can retry a failed event yourself. Delivery is not guaranteed.

  • Retries: If a delivery fails, we retry it on a set schedule.
  • Manual retry: You can retry a failed webhook event yourself.
  • Status: You can check whether a delivery succeeded or failed.