Configure DocuSign Connect webhooks to receive real-time envelope status events

In-depth guide

Steps

1. In the DocuSign Admin console (or via the Connect API), create a Connect configuration specifying your HTTPS endpoint URL, the triggering events (e.g., envelope-sent, envelope-completed, recipient-completed), and whether to include documents and form data in the payload.
2. Accept incoming POST requests at your endpoint; DocuSign sends an XML or JSON payload (depending on configuration) signed with an HMAC-SHA256 signature in the X-DocuSign-Signature-1 header.
3. Validate the HMAC signature using your Connect HMAC key before processing any payload to prevent spoofed events.
4. Respond with HTTP 200 within a few seconds; offload heavy processing to a background queue to avoid timeouts that trigger DocuSign's retry logic.
5. Handle duplicate deliveries idempotently by tracking processed envelopeId + status combinations in your datastore.
6. For missed events, backfill by querying GET /v2.1/accounts/{accountId}/envelopes?from_date=... to reconcile state.