Hello! I have a node.js application. I need 1 template. At any time I will want to fill out the data in this template, after that create a link for the user to sign in DocuSign. Also I want to receive a call back after successful signing.
I don’t understand how to implement it in node.js
Hey
You need to combine:
- envelope creation with templateId
parameter and templateRoles
array providing email
, name
, roleName
(based on what you have in your template) and clientUserId
(to allow you to generate a link to be accessed).
let envelopeDefinition = new docusign.EnvelopeDefinition();
envelopeDefinition.templateId = "ADD_YOUR_UUID_HERE";
let templateSigner = new docusign.TemplateRole();
templateSigner.name = "Sonny Signer";
templateSigner.email = "sonny@companyz.com";
templateSigner.roleName = "Signer"; // this should match your template
templateSigner.clientUserId = "USE_AN_UNIQUE_IDENTIFIER_PER_USER_HERE";
envelopeDefinition.templateRoles = =templateSigner];
envelopeDefinition.status = "sent";
- send this envelope definition using createEnvelope
method
let responseEnvelopeCreation = await envelopesApi.createEnvelope(accountId, { envelopeDefinition });
- once the envelope is sent, you need to collect the envelopeId
from the API request you are doing to Docusign and then generate a recipient view with createRecipientView
providing the same information you used in the envelope creation (email
, name
and clientUserId
) and a returnUrl
from your website where you are going to send the user to after signing the envelope:
let recipientViewRequest = new docusign.RecipientViewRequest();
recipientViewRequest.name = "Sonny Signer"
recipientViewRequest.email = "sonny@companyz.com"
recipientViewRequest.clientUserId = "USE_AN_UNIQUE_IDENTIFIER_PER_USER_HERE";
recipientViewRequest.returnUrl = "https://mywebsite.com/docusign/sign/return";
recipientViewRequest.authenticationMethod = "Password";
* "Password" is one authentication method used as example, see the proper one to use in our documentation
let responseRecipientView = await envelopesApi.createRecipientView(responseEnvelopeCreation.envelopeId, { recipientViewRequest });
* This responseRecipientView returns an URL where you are going to redirect the user to
- once you send the user to the signature page and their finish their activities there you are going to receive an event (for example, when user signs an envelope your returnUrl
receives a query string named event=signing_complete
) (you can see other possible events in our API reference page).
Once you receive this callback from Docusign you can execute the actions in your end depending on each event type you receive from us after the signature is completed.
Keep in mind the codes above are only focusing in the request structure but they are not complete (as they not cover the authentication parts, for example) and they can be changed in comparison with your code.
I hope I could help here.
Reply
Sign up
Already have an account? Login
You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.
Customer Login/Registration Developer Login/RegistrationDocusign Community
You can login or register as either a Docusign customer or developer. If you don’t already have a Docusign customer or developer account, you can create one for free when registering.
Customer Login/Registration Developer Login/RegistrationEnter your E-mail address. We'll send you an e-mail with instructions to reset your password.