Not Receiving Identity Verification (Pending/Completed) Webhook Events — Only Envelope Events

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! 🙏