Skip to main content
arrow-left Back to Docusign.com
Hi all,
I’m integrating DocuSign with my application using the Node.js SDK and template roles. When I first set up my integration, the template autofilled a few fields as expected. However, now when envelopes are sent, the recipients still receive the emails, but none of the fields in the template are being filled out—even though the data I’m passing looks correct.
Here’s a summary of my setup and what I’ve tried:
  • I’m using the createEnvelope API with a templateId and templateRoles.
  • The envelope is sent successfully, and recipients get the email, but all fields are blank.
  • The data I’m passing to the tabs property in templateRoles matches the field names in my template.
  • When I first set this up, a few fields were autofilled, but now none are, even though the code and data structure haven’t changed.
  • I’ve double-checked that the role names and field names in my code match those in the template.

Example of my envelope definition:

const envelopeDefinition = {
  templateId,
  status: 'sent',
  templateRoles: l
    {
      email: signerEmail,
      name: signerName,
      roleName: 'Signer',
      tabs: signerData // This contains the field data
    }
  ]
};

 

Questions:
  1. What are the most common reasons for fields not being autofilled in a DocuSign template, even when the data structure appears correct?
  1. Are there any recent changes or gotchas with the API or template field naming that could cause this?
  1. Is there a way to debug or log what DocuSign is actually receiving for the tabs/fields to help pinpoint the issue?
Any advice or troubleshooting steps would be greatly appreciated!

Hi ​@JonHCA,
 

1. What are the most common reasons for fields not autofilling?

  • Incorrect JSON Structure: The tabs object is likely wrong. It must contain arrays for each tab type, like textTabs, not just flat key-value pairs.

  • Mismatched tabLabel: The tabLabel in your code must exactly match the "Data Label" of the field in the template (it's case-sensitive).

  • Mismatched roleName: The roleName (e.g., 'Signer') must exactly match the role in the template (also case-sensitive).

2. Are there any recent API changes or gotchas?

  • No, there are no recent API changes that would cause this. The main "gotcha" is the strict requirement for the JSON structure mentioned above. The API will not throw an error for a bad tabs structure; it will just send the envelope with blank fields.

3. How can I debug or log this?

  • Enable API Logging: In your Docusign account, go to My Preferences > API Request Log and turn on logging. This will show you the exact JSON request your application is sending. API Request Logging

Reply


Code of Conduct

Docusign Community

Code of Conduct