Productivity
DocuSign Webhooks
Electronic signature and agreement platform. Receive events for envelope and recipient lifecycle changes via DocuSign Connect.
Connecting DocuSign to Hookbase
Create a source in Hookbase first — it gives you an ingest URL to paste into DocuSign. Then:
- 1Go to DocuSign Admin → Integrations → Connect → Add Configuration (Custom)
- 2Set "URL to Publish" to your Hookbase ingest URL and choose JSON as the message format
- 3Under "Events", select the envelope and recipient statuses that should trigger a notification (e.g. Envelope Sent, Envelope Completed)
- 4Open the Connect Keys tab, click "Add Secret Key" and copy the key now (it's shown once). Paste it into your Hookbase source as the Secret Key
- 5In the Connect configuration, tick "Include HMAC Signature" and save. Keep only one active key: Hookbase verifies X-DocuSign-Signature-1 only
Signature verification
Set the source's provider to docusign and paste the signing secret. Every request is checked before the event is stored, and anything that fails is rejected rather than quietly recorded.
- Algorithm
- HMAC-SHA256 (base64)
- Header
- X-DocuSign-Signature-1
- Where to find the secret
- DocuSign Admin → Integrations → Connect → Connect Keys → Add Secret Key (copy it now, it's shown once), then tick "Include HMAC Signature" on the Connect configuration. Hookbase checks every X-DocuSign-Signature-N header, so the key can be in any slot and rotation keeps working.
DocuSign event types
8 of the events people route most often. Hookbase accepts every event DocuSign sends, whether or not it is listed here.
envelope-sent
An envelope was sent to its recipients
envelope-delivered
All recipients have viewed the envelope
envelope-completed
All recipients completed their required actions and the envelope is finished
envelope-declined
A recipient declined to sign the envelope
envelope-voided
The sender voided the envelope before completion
recipient-completed
An individual recipient finished signing or approving
recipient-declined
An individual recipient declined to sign
recipient-authenticationfailed
A recipient failed an identity authentication check
What a DocuSign webhook looks like
A envelope-sent payload. Hookbase stores the raw body exactly as it arrived, so this is also what you get back on a replay.
{
"event": "envelope-sent",
"apiVersion": "v2.1",
"uri": "/restapi/v2.1/accounts/1234567/envelopes/a1b2c3d4-5678-90ab-cdef-1234567890ab",
"retryCount": 0,
"configurationId": 10000001,
"generatedDateTime": "2024-01-15T10:30:00.0000000Z",
"data": {
"accountId": "1234567",
"envelopeId": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"envelopeSummary": {
"status": "sent",
"emailSubject": "Please sign: Services Agreement",
"sentDateTime": "2024-01-15T10:30:00.0000000Z",
"recipients": {
"signers": [
{
"recipientId": "1",
"name": "Alex Doe",
"email": "alex@example.com",
"status": "sent"
}
]
}
}
}
}Start receiving DocuSign webhooks
Create a source, paste the URL into DocuSign, and watch the first event arrive. The free tier includes 1,000 events a month.
Get Started Free