Signers

Create signer

Create a signer in the workspace.

Copy as Markdown Open in ChatGPT Open in Claude

post/v1/accounts/{accountId}/signers

Request

  • Base URL
    https://api.assinafy.com.br
  • URL
    https://api.assinafy.com.br/v1/accounts/{accountId}/signers
  • Auth
    • HTTP bearer
    • or API key in header X-Api-Key

Path parameters

accountIdstring required

Workspace account ID.

Request body

full_namestring required
emailstring email
whatsapp_phone_numberstring

E.164; normalized on save.

government_idstring

Signer's CPF (11 digits) or CNPJ (14 characters; may be alphanumeric). Formatting is accepted and the value is normalized on save. Required before the signer can use a verification method that identifies them by CPF.

Example request

{
  "full_name": "John Dove",
  "email": "john@email.com",
  "whatsapp_phone_number": "+5548999990000",
  "government_id": "390.533.447-05"
}

Response

The created signer

statusinteger

HTTP status code, mirrored in the body.

messagestring

Human-readable message; empty on success.

Example response

{
  "status": 200,
  "data": {
    "resource": "signer",
    "id": "62d6ee35c7741ca4006b9e11",
    "full_name": "John Signer",
    "email": "john@email.com",
    "whatsapp_phone_number": "+5548999990000",
    "government_id": "39053344705"
  }
}

Changes