Skip to main content

Hi DocuSign Community,

I'm working on an integration where I need to detect when the first recipient (vendor) signs a document so I can trigger a specific workflow (update status, send notifications, etc.).
However, despite configuring my DocuSign Connect webhook to include recipient-signed and recipient-completed, I only receive the envelope-completed event, and never any recipient-level ones.

🔧 My Setup:

  • I’ve registered a webhook using the POST /accounts/{accountId}/connect API.

  • events configured:

 

json

CopyEdit

events: e "recipient-signed", "recipient-completed", "envelope-completed", "envelope-declined", "envelope-voided" ]

  • The webhook URL is a secure public HTTPS endpoint (not localhost/tunnel).

  • Routing order is sequential:

    • Vendor (routingOrder: 1)

    • Company Signatory (routingOrder: 2)

  • The webhook handler correctly receives envelope-completed when all parties sign — but I do not receive recipient-completed or recipient-signed when just the vendor signs.

✅ Goal:

Trigger my logic immediately after the vendor signs, before the company signatory does.

❓Questions:

  1. Do I need to explicitly enable Recipient Connect on my DocuSign account for recipient-completed to fire?

  2. Is there anything else required in my Connect configuration or recipient setup to get per-recipient webhook events?

  3. Is recipientId reliably available in the webhook payload for mapping signers?

Any help or guidance would be appreciated!

Thanks,
Alfaj Mahat
(Verifiable Contract Platform Dev Team)

Hi Alfaj,

I would recommend creating a support case so that we can investigate this with you with examples. You can create a support case via the support portal, found here: https://support.docusign.com/s/?language=en_US&rsc_301

Best regards,

Jonathan | Docusign Developer Support


Hi ​@Alfaj !

As Jonathan mentioned, I think the Customer Support will be able to help you deeper on this question, since there’re many things involved on it.

 

However, let me try to provide some tips about your scenario:

  1. Check about the recipients routing order. We recommend (but not mandatory) that you use a routing order, so Docusign will send different status as “recipient-completed” for 1st signer, and then “recipient-deliver” for the 2nd signer.
  2. Pay attention on the “Event Message Delivery Mode” config. There are two option on it, the Aggregate (Docusign will consolidate the last updates in one message) or Send Individual Messages (SIM) (when Docusign will send each event individually - careful to not cause your listener server busy). May your system are receiving Agrregate messages, and it can’t determine more than 1 status at the same time.
  3. Verify the Envelope and Recipients Trigger Events. My suggestion is to check all available checkboxes for a quick test, so you should receive any new update about the envelope.

 

Finally, I did a quick test using my demo account. My settings are showing below, and you can check that I received the “recipient-completed” status.

 

Please, let me know if I was able to help you with this question. If so, could you please select click on the "Select as Best" option? Thank you!
 


Reply