Skip to content

Errors

Mixed Placeholders

A document mixes legacy signature placeholders with places. Use generic placeholders with places, or use only legacy signature placeholders.

What Happened

The document mixes legacy signature placeholders with the newer places system. A document must use one positioning approach or the other, not both.

Left, rejected: a document with a legacy signature placeholder (client.signature) and a places list. Right, accepted: a document whose placeholder client_signs_here matches a place in the places list.

Example response

422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/mixed-placeholders",
  "title": "Mixed Placeholders",
  "status": 422,
  "detail": "Mixing signature placeholders and places is not allowed. Please convert your signature placeholders to generic placeholders or prevent the use of places with the current document."
}

How to Fix

  • Convert legacy signature placeholders ([[key.signature]]) to generic placeholders ([[key]]) and define each one as a place.
  • Alternatively, remove the places from the document and use only legacy signature placeholders.
  • See the Placeholders documentation for details on the current placeholder format.

  Still stuck? Contact support.