Places
Signature Places (Legacy)
Mark where each recipient signs with legacy [[key.signature]] placeholders, and convert them to signature place objects with page positions or placeholders.
Power Automate flows use the new places too, through the Add Place actions. See places in Power Automate.
Each recipient has a key that identifies them within an envelope. In an employment contract, for example, the keys can be manager and employee.
SignatureAPI uses placeholders to identify where each signature should go in a document. It uses the recipient’s key to find their signing place.
The format of a signature placeholder is like this [[key.signature]], where key is the recipient’s key.
For example, in an employment contract, the place where the manager signs is marked:
[[manager.signature]]
and where the employee signs, is marked:
[[employee.signature]]
In the document, placeholders will look like this:

After signing, the document will look like this:

We recommend changing the placeholder text color to white. This will make the placeholders invisible in the document:

If you need help with your templates, reach out to support.
Converting to signature places
A document can’t mix both kinds: when it contains a legacy [[key.signature]] placeholder and the document also defines places, the API returns a mixed-placeholders error. Convert all legacy placeholders in a document at once. Legacy placeholders also work only when every recipient signs: an envelope with a preparer or an approver returns an unsupported-recipient-type error.
Replace each legacy placeholder in your document file with the new one, then add the places to the document object. Without height, a signature place is 60 points tall and 150 points wide.
Legacy signature place migrator
Turn legacy signature placeholders into signature places.
Paste document text with legacy [[key.signature]] placeholders and get signature place objects plus the new placeholders to type into the document.
| Legacy placeholder | New placeholder |
|---|---|
[[manager.signature]] | [[manager_signature]] |
[[employee.signature]] | [[employee_signature]] |
{
"places": [
{
"key": "manager_signature",
"type": "signature",
"recipient_key": "manager"
},
{
"key": "employee_signature",
"type": "signature",
"recipient_key": "employee"
}
]
}A document uses either legacy placeholders or places, never both. Power Automate supports only legacy signature places.
Placeholders to replace
Manager: [[manager_signature]]
Employee: [[employee_signature]] {
"places": [
{
"key": "manager_signature",
"type": "signature",
"recipient_key": "manager"
},
{
"key": "employee_signature",
"type": "signature",
"recipient_key": "employee"
}
]
}