Signer Roles

Signer roles are templates — they define who will sign (e.g. "Client", "Witness") without specifying actual people. Real signers are added when you create a submission.

Create a signer role

The API auto-assigns a color and a role identifier (signer_1, signer_2, etc.).

curl -X POST https://formalingo.com/api/v1/documents/DOC_ID/signer-roles \
  -H "Authorization: Bearer af_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Client" }'

{
  "success": true,
  "data": {
    "id": "role-uuid",
    "documentId": "doc-uuid",
    "role": "signer_1",
    "label": "Client",
    "color": "#2563EB",
    "order": 0
  }
}

The role value (e.g. signer_1) is what you reference when placing fields (assigneeRole) and when creating submissions.