Skip to main content
Newcomer
March 9, 2026
Question

Tab values not filling when creating envelope from template via API

  • March 9, 2026
  • 1 reply
  • 49 views

Hi,

I'm creating envelopes from a template using the REST API. 
The envelope is created successfully but all text field 
values remain empty.

Setup:
- Production account
- POST /v2.1/accounts/{accountId}/envelopes
- Text fields placed under Company Rep recipient
- Tab labels are auto-generated UUIDs

Things I already tried:
- Sending tab values in templateRoles in the POST request
- PUT request to update tabs after creation using tabLabel and tabId
- Enabled "write initial value of fields for all recipients" setting

All attempts result in a correct draft but with empty fields.

What is the correct way to pre-fill text tab values from a 
template via API?

Thank you.

1 reply

JohnSantos
Guru
Guru
March 10, 2026

@Abdul 

The right approach depends on what kind of tabs those are. If the text fields are assigned to the Company Rep recipient, they are recipient tabs, not sender pre-fill tabs. In that case, the normal pattern is to set their values when you create the envelope from the template, inside the matching templateRoles[].tabs.textTabs[] object for that role. DocuSign’s tabs documentation distinguishes recipient tabs from sender pre-filled tabs, and the prefilled-tabs docs make clear that sender pre-fill fields are a separate tab type.  https://developers.docusign.com/docs/esign-rest-api/esign101/concepts/tabs/prefilled-tabs/

Welcome to the DocuSign Community! Your feedback is highly valued. If you find my response helpful, please give it a "Like" and consider marking it as the "Best Answer" to assist others with similar issues.