+2Hello,
We are calling the eSignature API to retrieve the template ID used in an envelope (/envelopes/xxx/templates). Sometimes these calls return empty responses whereas envelopes were using a template - see below example :
Can someone explain why templates are not retrieved correctly ?
Thank you !
Best answer by Koll.Klienstuber
If you are not seeing the template show up in the GET Request when you use the below endpoint it might be caused if the envelope was in fact not created using a template.
https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopetemplates/list/
You might also want to try using the additional but optional query parameters. For example
GET: https://demo.docusign.net/restapi/v2.1/accounts/accountIDHere/envelopes/EnvelopeIDHere/templates?include=matching
or
GET: GET: https://demo.docusign.net/restapi/v2.1/accounts/accountIDHere/envelopes/EnvelopeIDHere/templates?include=applied
If this is reproducible on command and you are sure templates are being used to create the envelope, a case with our developer support team would be the suggested next step.
If you do end up creating a support case you would want to capture an API log of the issue being reproduced and attach the log onto the support case. You can capture API logs by following the steps shown here while logged into the account of the user making the API request: https://support.docusign.com/s/document-item?language=en_US&rsc_301&bundleId=jux1643235969954&topicId=poz1578456669909.html&_LANG=enus
One other approach would be to follow the guide below in order to track template usage when creating envelopes: https://www.docusign.com/blog/developers/the-trenches-track-your-templates-envelope-custom-fields
+14Hello,
Welcome to the Docusign Community!
Have you read this article?
Creating and using templates - using REST API
https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/templates/creating/
There are some examples and other more specifc links for your need.
I hope that helps.
Best,
Alexandre
+2Hi Alexandre,
Thanks for your answer, I read the article and related links. I forgot to mention that we are not using the API to create the envelopes, it is done through the Web UI by selecting a template and then the “Use” button.
As you can see on the “Envelope report” screenshot above, all envelopes have a template ID but the API query does not return them.
+2The issue occurs when we create an envelope using a template without any document, then we manually upload the document to be signed.
In those cases, the query /templates on the envelope is empty {} but we still need to get the selected template ID.
+3If you are not seeing the template show up in the GET Request when you use the below endpoint it might be caused if the envelope was in fact not created using a template.
https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopetemplates/list/
You might also want to try using the additional but optional query parameters. For example
GET: https://demo.docusign.net/restapi/v2.1/accounts/accountIDHere/envelopes/EnvelopeIDHere/templates?include=matching
or
GET: GET: https://demo.docusign.net/restapi/v2.1/accounts/accountIDHere/envelopes/EnvelopeIDHere/templates?include=applied
If this is reproducible on command and you are sure templates are being used to create the envelope, a case with our developer support team would be the suggested next step.
If you do end up creating a support case you would want to capture an API log of the issue being reproduced and attach the log onto the support case. You can capture API logs by following the steps shown here while logged into the account of the user making the API request: https://support.docusign.com/s/document-item?language=en_US&rsc_301&bundleId=jux1643235969954&topicId=poz1578456669909.html&_LANG=enus
One other approach would be to follow the guide below in order to track template usage when creating envelopes: https://www.docusign.com/blog/developers/the-trenches-track-your-templates-envelope-custom-fields
Already have an account? Login
Join the Docusign Community by logging in with your Docusign developer or customer account credentials.
Don’t have an account? You can create a free one when registering.
Note: Partner-specific logins are not available yet. Partners should log in as either a customer or developer
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
Back to Docusign.com
