Skip to main content
Question

Assign PDF Form Field Transformations to different signers

  • January 2, 2026
  • 2 replies
  • 15 views

Forum|alt.badge.img+1

We have a requirement to send a PDF document via the API and have the PDF fields converted to tabs for the signers. There can be multiple signers, and we send to the API the signers and the fields that should be mapped to those signers. Using a modified example from the API documentation (below), we include a second recipient and map the `DocusignInitialHere2` field to that one, where the other fields are mapped to recipient ID 1.

{
"status": "sent",
"emailSubject": "PDF Transform Example 2",
"recipients": {
"signers": [
{
"email": "sally@email.com",
"name": "Sally Dough",
"recipientId": "1",
"tabs": {
"initialHereTabs": [
{
"tabLabel": "DocusignInitialHere1"
},
{
"tabLabel": "DocusignInitialHereOptional1",
"optional": "true"
}
]
}
},
{
"email": "sue@email.com",
"name": "Sue Dough",
"recipientId": "2",
"tabs": {
"initialHereTabs": [
{
"tabLabel": "DocusignInitialHere2"
}
]
}
}
]
},
"documents": [
{
"documentId": "1",
"name": "contract.pdf",
"transformPdfFields": true,
"assignTabsToRecipientId": "1"
}
]
}

 

I see in the documentation that using PDF transformation will always assign all the tabs created to a single signer, but is there no way we can send through something like the above to ensure that Docusign knows which auto-created tabs to assign to the correct signers?

2 replies

Forum|alt.badge.img
  • Docusign Employee
  • January 4, 2026

 

Hello Guy CQ,

Thank you for contacting Docusign Developer Support. 

We understand your need to distribute the PDF's fields to the corresponding recipients when the envelope is created. 

However, at this moment, our field conversion tool only assign PDF fields to the first recipient. 

You can use this guide to add other fields or recreate the fields that need to be assigned to the other recipients:

EnvelopeRecipientTabs Resource | REST API | Docusign

Our apologies for the inconvenience. 

Best regards,

Adrian | Docusign Developer Support


Forum|alt.badge.img+1
  • Author
  • Newcomer
  • January 5, 2026

Hi Adrian

Thanks, we’ll figure out a way to use white-text anchor tagging instead.

Kind regards

Guy