Skip to content
FirmEasy
← Inicio

Create Signers

POST
https://app.firmeasy.legal/api/v1/electronica/firmantes

Create Signers

Section titled “Create Signers”

This endpoint allows you to register one or more signers associated with a specific electronic document. You can configure signature flows (standard or advanced) and the exact coordinates where the signature will be placed within the document.

Authorization

Section titled “Authorization”

This resource is protected. You must include your access token in the request header.

Authorization
string
Access token (Bearer token).
Limits:Required
Content-Type
string
Specifies the request format.
Limits:application/json

Request Parameters

Section titled “Request Parameters”
Required Fields

Fields marked with an asterisk (*) are required and must be provided in the request. Other fields are optional.

The request body requires the file ID and an array of objects with each signer’s information.

archivo_id
string
ID of the file to which signers will be added.
Limits:Required (UUID)
firmantes
array
List of objects with each signer's data and configuration.
Limits:Minimum 1 signer

firmantes object fields

Section titled “firmantes object fields”
  • nombre: Full name of the signer.
  • email: Email address.
  • celular / codigo_pais: Contact data.
  • send_link: Boolean to send automatic link.
  • flujoEstandar / flujoAvanzado: Arrays to define validation methods (e.g. firma_biometrica, selfie).
  • signature_position_x, y: Signature placement coordinates.
  • signature_page: Page number to stamp the signature.

Implementation Examples

Section titled “Implementation Examples”

cURL

Section titled “cURL”
Ventana de terminal
curl -X POST [https://app.firmeasy.legal/api/v1/electronica/firmantes](https://app.firmeasy.legal/api/v1/electronica/firmantes) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "archivo_id": "466693fc-025a-4b41-8874-08160d0d2458",
    "firmantes": [
        {
            "nombre": "Nombre del firmante",
            "email": "[email protected]",
            "celular": "9999999999",
            "codigo_pais": "+51",
            "send_link": false,
            "flujoEstandar": ["firma_biometrica"],
            "flujoAvanzado": ["selfie"],
            "signature_position_x": 330,
            "signature_position_y": 540,
            "signature_page": 1
        }
    ]
}'

Node.js (Fetch)

Section titled “Node.js (Fetch)”
const raw = JSON.stringify({
  "archivo_id": "466693fc-025a-4b41-8874-08160d0d2458",
  "firmantes": [
    {
      "nombre": "Nombre del firmante",
      "email": "[email protected]",
      "celular": "9999999999",
      "codigo_pais": "+51",
      "send_link": false,
      "flujoEstandar": ["firma_biometrica"],
      "flujoAvanzado": ["selfie"],
      "signature_position_x": 330,
      "signature_position_y": 540,
      "signature_page": 1
    }
  ]
});


// ... (Headers and fetch configuration same as previous examples)

Status Codes

Section titled “Status Codes”
Code Status Description
200 OK Signer registered successfully.
400 Bad Request JSON error or missing required data.
401 Unauthorized Missing or invalid token.
500 Server Error Internal server failure.