Skip to content

Errors

Cannot Populate Template

The data could not be merged into the DOCX document. Check the detail for the missing or mismatched merge field and fix the document's data.

What Happened

SignatureAPI could not merge the document’s data into the DOCX document. The usual cause is a merge field in the document that has no matching value in data. The detail property names the document by its position in the documents array, such as documents[0], and says what went wrong.

Example response

422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-populate-template",
  "title": "Could Not Populate Template",
  "status": 422,
  "detail": "documents[0] could not be merged with the data: the data has no value for the merge field position"
}

How to Fix

  • Read the detail to find the missing or mismatched field.
  • Give every field and conditional in the document a matching entry in data.
  • Field names are case-sensitive. Make sure each name in the document matches its key in data exactly.
  • Send conditional values as the type the document expects, for example the boolean true and not the string "true".

  Still stuck? Contact support.