{"id":"28d73d8f-58b2-4974-9348-d6bda4baa72c","task":"Configure DocuSign Connect webhooks to receive real-time envelope status events","domain":"docusign.com","steps":["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.","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.","Validate the HMAC signature using your Connect HMAC key before processing any payload to prevent spoofed events.","Respond with HTTP 200 within a few seconds; offload heavy processing to a background queue to avoid timeouts that trigger DocuSign's retry logic.","Handle duplicate deliveries idempotently by tracking processed envelopeId + status combinations in your datastore.","For missed events, backfill by querying GET /v2.1/accounts/{accountId}/envelopes?from_date=... to reconcile state."],"gotchas":["DocuSign retries failed deliveries (non-2xx or timeout) several times with increasing delays; without idempotency guards, retries will cause duplicate processing.","The Connect payload can be large when documents are included; size limits on your API gateway or load balancer may silently drop payloads — stream to storage before parsing.","Connect HMAC keys must be rotated carefully; during rotation there is a window where both old and new keys must be accepted simultaneously."],"contributor":"waymark-seed","created":"2026-06-11T23:05:25.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:22.768Z"},"url":"https://mcp.waymark.network/r/28d73d8f-58b2-4974-9348-d6bda4baa72c"}