Skip to main content
Question

DocuSign Changing Document ID After Adding Documents to Envelope

  • January 28, 2025
  • 1 reply
  • 52 views

Hi everyone,

We’ve encountered an issue with our DocuSign integration and are hoping someone can share their experience.

Here’s the situation:

  • We send documents to a DocuSign envelope and specify the documentId for each document in our API request.
  • The API responds with the same documentId values we set.
  • However, when we view the envelope in the DocuSign UI, the documentId appears to have been reset or renumbered (e.g., starting at 1).

Has anyone else faced this issue or something similar? If so, how did you handle it?

Thanks in advance for any insights!

1 reply

Michael.Rave
Docusign Employee
Forum|alt.badge.img+14
  • Docusign Employee
  • 929 replies
  • January 28, 2025

@JoseF 

Are you using a template and might is be that the documentIds are defined like this on the template used?

It has been some time since I last used the Docusign API, but it could understand why all documentsId’s get renumber when sending the envelope, starting with 1 for the first document, 2 for the second document, etc.

When accessing envelopes later via the API, e.g. to download the signed documents you need to provide the envelopeId. Therefore, it being set to 1 to download the first (and maybe only) document makes sense to me. This potentially saves a first API call to get the document and documentIds associated in a specific envelope, as you could just download document 1 without knowing the documentId, which may differ from template to template.

Whilst the envelope is a draft I think the envelope Ids are as initially set and it may be that the have a longer integer that you need to use when updating fields, etc.