Hi everyone,
We're using the DocuSign API to send legal agreements (Unilateral Undertaking and Customer Supply Agreement) via our platform. The envelope is generated using the primary user's profile — it includes their name, address, and other key details. That user is assigned as the signer and receives the envelope via email.
However, in many cases the property has two owners, and we need both individuals to sign the same document — even though it’s initially triggered and sent using just one user's profile and email.
Our goals:
-
The primary user receives the envelope and signs as normal.
-
The same envelope should allow a second person (co-owner) to sign.
-
This may either be:
-
Another signer using the same email address, or
-
A second signer added by the first signer at the time of signing (if possible).
-
Our questions:
-
What’s the best way to set up the envelope via the API to allow two signers, if we only have the primary signer’s email at the time of sending?
-
Can both recipients use the same email address but sign as distinct signers with separate fields?
-
Is there a way for the first signer to add a second signer (e.g., manually enter the co-owner’s name/email)?
-
What’s the best practice for ensuring both owners are properly bound and tracked in the envelope audit trail?
We are using POST /v2.1/accounts/{accountId}/envelopes
and passing signer info via templateRoles
.
Any examples, guidance or recommended patterns would be hugely appreciated.
Thanks in advance!