Skip to main content

Hi DocuSign team 👋,

I’m integrating Identity Verification (IDV) in our Laravel-based app and connected it with a DocuSign Connect webhook.

Everything works fine for regular eSignature events — I successfully receive:

  • recipient-completed

  • envelope-completed

  • envelope-voided, etc.

However, I never receive the two Identity Verification events even though they are enabled in my Connect configuration:

✅ “Identity Verification Pending”
✅ “Identity Verification Completed”

Setup details

  • Webhook URL: (public ngrok HTTPS endpoint)

  • Environment: Demo (developer)

  • Using REST API v2.1

  • Envelope created via API with the following recipient structure:

 

"recipients": { "signers": [{ "email": ",information removed", "name": "ANKITKUMAR SUTHAR", "recipientId": "1", "routingOrder": "1", "identityVerification": { "workflowId": "9bbb5cce-6c25-42d6-8934-2799d18947ef" } }] }

  • The envelope completes correctly, IDV passes, and I get envelope-completed in my webhook.

  • The webhook itself works fine — verified by logs and ngrok captures.

  • But I never see any identity-verification-pending or identity-verification-completed events either in:

    • Connect → Logs → All Events, or

    • My webhook logs.

Questions

  1. Is there any extra step or account feature required to enable IDV webhook events (Pending/Completed)?

  2. Do these events only trigger for specific workflow types (e.g., idv_with_liveness) and not for ds_identify_default?

  3. Should I be using Identity Evidence API or a specific setting in “Identity Verification → Evidence Reports”?

  4. What’s the correct flow DocuSign recommends for real-time IDV result handling — via webhook events or polling the ID Evidence API?

Goal

We want to automatically mark users as “verified” or “failed” in our app as soon as the IDV process completes — without waiting or polling.
Could you please confirm the correct flow and whether my current setup should already be receiving those events?

Thanks in advance for clarifying! 🙏

Be the first to reply!