VAMOSIGNGratis, en todos los planes

API y MCP de firma electrónica: envía desde tu sistema

Respuesta breve: crea una clave API en la sala de Desarrolladores de VAMOSIGN y llama a diez acciones mediante REST o MCP. Tu sistema, un script o un asistente de IA envía la solicitud, los firmantes reciben sus enlaces por correo electrónico y un webhook notifica a su sistema cuando un documento está firmado y sellado. Sin SDK: es REST simple y el Protocolo de Contexto de Modelo. El envío de un documento y la verificación de su estado funcionan en todos los planes.

Paso a paso

Por ejemplo: un sistema de gestión de casos que envía una carta de compromiso cuando se abre un caso.

TúVAMOSIGNFirmantes y otros
  1. 1
    Una vez · Tú

    Abres Desarrolladores en VAMOSIGN y creas una clave API para el espacio de trabajo.

  2. 2
    Una vez · Tú

    Añades un webhook: una dirección en tu sistema y los eventos que deseas, como document.sealed.

  3. 3
    Se abre el caso · Tu sistema

    Tu sistema llama a send_for_signature con el documento, un título y los firmantes. Por REST o como herramienta MCP, es la misma acción.

    POST https://app.vamosign.com/v1/send_for_signature
    Authorization: Bearer <your API key>
    Content-Type: application/json
    
    {
      "title": "Engagement letter",
      "document_base64": "…",
      "signers": [{"name": "Kari Nordmann", "email": "kari@example.com"}]
    }
    
  4. 4
    Mismo segundo · VAMOSIGN

    VAMOSIGN responde con el id de la solicitud y envía por correo electrónico a cada firmante su enlace.

  5. 5
    Más tarde · Los firmantes

    Los firmantes firman en el navegador, como con cualquier solicitud.

  6. 6
    Cada firma · VAMOSIGN

    VAMOSIGN envía signature.completed a tu webhook. El cuerpo está firmado con HMAC-SHA256 en el encabezado X-Signer-Signature, para que tu sistema pueda verificar que proviene de VAMOSIGN.

  7. 7
    Cuando esté listo · VAMOSIGN

    VAMOSIGN envía document.sealed. Tu sistema llama a check_status con el id para leer quién firmó y cuándo.

    GET https://app.vamosign.com/v1/check_status?id=…
    Authorization: Bearer <your API key>
    
    {
      "id": "…",
      "status": "completed",
      "sealed": true,
      "signers": [
        {"name": "Kari Nordmann", "email": "kari@example.com", "status": "signed", "signed_at": "2026-09-29T12:15:00+02:00"}
      ]
    }
    
  8. 8
    Cualquier momento · Tú

    La sala de Desarrolladores muestra cada entrega de webhook, incluidas las que fallaron.

Cada argumento

Cada llamada necesita dos encabezados: tu clave API del espacio de trabajo como token bearer, y Content-Type: application/json. Las herramientas MCP toman los mismos argumentos, bajo los mismos nombres.

OpenAPI: https://app.vamosign.com/openapi.json

POST https://app.vamosign.com/v1/send_for_signature

Envía un documento a una o más personas. Proporciona una plantilla o un PDF.

titlestringrequerido
El nombre del documento. Los firmantes lo ven.
messagestring
Una nota para los firmantes. VAMOSIGN la incluye en la invitación.
templatestring
El nombre o slug de una plantilla. VAMOSIGN envía su versión actual.
document_base64string
El PDF, codificado en base64. Usa esto cuando no proporciones ninguna plantilla.
filenamestring
El nombre del archivo. Si lo omites, es dokument.pdf.
order"parallel" | "sequential"
paralelo: VAMOSIGN solicita a todos a la vez. Esta es la opción predeterminada. secuencial: VAMOSIGN les solicita en el orden en que los enumeras y escribe a cada persona cuando la anterior ha firmado.
sign_bystring
El último día en que se puede firmar el enlace, como AAAA-MM-DD. Después de ese día nadie puede firmar, y puedes mover la fecha. Si lo omites, el enlace permanece abierto hasta que todos hayan firmado.
expires_onstring
La fecha en que vence el acuerdo, como AAAA-MM-DD.
expires_after_monthsinteger
El acuerdo caduca esta cantidad de meses después de la última firma, de 1 a 120. Proporciona esto o expires_on, no ambos. Si se omite con una plantilla, se mantienen los meses propios de la plantilla.
send_nowtrue | false
Establécelo en false y VAMOSIGN guarda un borrador, para que una persona lo envíe desde Documentos. Si lo omites, VAMOSIGN lo envía de inmediato.
questionsarray
Lo que los firmantes deben responder al firmar, un objeto cada uno. Necesita Team. Las preguntas propias de una plantilla también se hacen.
promptstringrequerido
La pregunta, tal como la lee el firmante.
shape"short_text" | "long_text" | "one_of" | "several_of" | "yes_no" | "number" | "date"
Cómo responde el firmante. Si lo omites, es short_text.
requiredtrue | false
Establécelo en false y el firmante puede dejar la pregunta vacía. Si lo omites, el firmante debe responder antes de firmar.
optionsarray
Las opciones, para one_of y several_of.
whostring
La dirección de correo electrónico del único firmante al que se le solicita. Si la dejas en blanco, VAMOSIGN pregunta a todos.
redact_after_weeksinteger
Semanas después de que la persona firme en que VAMOSIGN elimina la respuesta. La vacía, sella el documento de nuevo con la respuesta marcada como eliminada y te avisa. 1 o más. Si lo dejas en blanco, la respuesta se queda en el documento. En Team y superiores.
signersarrayrequerido
Las personas que firman, un objeto cada una:
namestring
El nombre de la persona. Si lo omites, VAMOSIGN usa la parte de su dirección antes de la @.
emailstringrequerido
Dónde VAMOSIGN envía el enlace. VAMOSIGN omite a una persona sin una dirección válida.
phonestring
Un número móvil con su código de país, como +47. En Starter y superiores, VAMOSIGN también envía el enlace por SMS.
sign_method"simple" | "selfie"
simple: la persona escribe su nombre. Esta es la opción predeterminada. selfie: la persona toma una fotografía de sí misma en la página de firma.
localestring
El idioma en el que VAMOSIGN escribe a esta persona: en, nb, es. Si lo omites, VAMOSIGN usa el idioma de tu espacio de trabajo.
companyobject
Si se omite, la persona firma como particular. Si se indica, es la empresa por la que firma: name, org_number, country (dos letras, como NO) y, para una empresa noruega, check: signatur o prokura. Con check, VAMOSIGN consulta en el registro mercantil noruego (Brreg) quién puede firmar por la empresa, y el certificado muestra lo que dijo el registro al sellar el documento.

Recibes: id, ref, title, status, state, sha256, expires_on, expires_after_months, sign_by, sealed y signers. Cada firmante tiene name, email, method, wave, status, signed_at y answers. Cuando el acuerdo vence algunos meses después de la última firma, expires_on se completa cuando el documento se sella.

POST https://app.vamosign.com/v1/bulk_send

Envía el mismo documento a una lista de personas. Requiere Team.

templatestring
El nombre o slug de una plantilla. VAMOSIGN envía su versión actual.
document_base64string
El PDF, codificado en base64. Usa esto cuando no proporcionas ninguna plantilla.
filenamestring
El nombre del archivo. Si lo omites, será dokument.pdf.
mode"separate" | "shared"
separate: cada persona firma su propia copia, y cada copia obtiene su propio certificado. Esta es la opción predeterminada. shared: todos firman un solo documento.
recipientsarrayrequerido
Las personas a las que va el documento, un objeto por cada una:
namestring
El nombre de la persona. Si lo omites, VAMOSIGN usa la parte de su dirección antes de la @.
emailstringrequerido
Dónde VAMOSIGN envía el enlace. VAMOSIGN omite a una persona sin una dirección válida.
phonestring
Un número móvil con su código de país, como +47. En Starter y superiores, VAMOSIGN también envía el enlace por SMS.
sign_method"simple" | "selfie"
simple: la persona escribe su nombre. Esta es la opción predeterminada. selfie: la persona toma una fotografía de sí misma en la página de firma.
common_signersarray
Personas que firman cada copia, después de su destinatario. Un objeto cada una. La persona que creó la clave API firma al final.
namestring
El nombre de la persona. Si lo omites, VAMOSIGN usa la parte de su dirección antes de la @.
emailstringrequerido
Dónde VAMOSIGN envía el enlace. VAMOSIGN omite a una persona sin una dirección válida.

Recibes: batch, que es la referencia del envío, y requests, con una entrada por solicitud, como la que devuelve send_for_signature.

GET https://app.vamosign.com/v1/check_status

Te indica en qué estado se encuentra una solicitud, quién ha firmado y todo lo que le ha sucedido. Esto es un GET, así que pon el argumento en la dirección.

request_idstringrequerido
El id que devolvió send_for_signature. También puedes llamarlo id.

Recibes: Todo lo que devuelve send_for_signature, y eventos. Cada evento tiene at, action, actor e ip. Cada una de las respuestas de un firmante tiene question y answer.

POST https://app.vamosign.com/v1/request_new_version

Solicita a todos los que firmaron una versión anterior de una plantilla que firmen la versión actual. Cada persona recibe su propia solicitud. Requiere Team.

templatestringrequerido
El nombre o slug de la plantilla.

Recibes: template y requests, con una entrada por solicitud.

POST https://app.vamosign.com/v1/add_signer

Añade una persona a un borrador o a una solicitud ya enviada. Donde se pregunta a todos a la vez, VAMOSIGN escribe a la nueva persona de inmediato. Donde se pregunta en orden, la nueva persona firma la última. La empresa se indica al crear la solicitud, no aquí.

request_idstringrequerido
El id que devolvió send_for_signature.
namestring
El nombre de la persona. Si lo omites, VAMOSIGN usa la parte de su dirección anterior a la @.
emailstringrequerido
Adónde envía VAMOSIGN el enlace. Una dirección que ya está en la solicitud se rechaza.
phonestring
Un número de móvil con su prefijo de país, como +47. En Starter y superiores, VAMOSIGN también envía el enlace por SMS.
sign_method"simple" | "selfie"
simple: la persona escribe su nombre. Es el valor por defecto. selfie: la persona se toma una fotografía en la página de firma.
localestring
El idioma en el que VAMOSIGN escribe a esta persona: en, nb, es. Si lo omites, VAMOSIGN usa el idioma de tu espacio de trabajo.

Recibes: La solicitud tal como la devuelve send_for_signature, con la nueva persona en signers.

POST https://app.vamosign.com/v1/send_reminder

Envía de nuevo la invitación a todos los que tienen el turno de firmar. A la persona que creó la clave API nunca se le envía un recordatorio.

request_idstringrequerido
El id que devolvió send_for_signature.

Recibes: La solicitud tal como la devuelve send_for_signature, y reminded: a cuántas personas escribió VAMOSIGN.

POST https://app.vamosign.com/v1/cancel_request

Retira una solicitud que no ha terminado. Nadie puede firmarla después. Una solicitud que todos han firmado queda como está.

request_idstringrequerido
El id que devolvió send_for_signature.

Recibes: La solicitud tal como la devuelve send_for_signature, con el estado cancelled.

GET https://app.vamosign.com/v1/get_document

Te da un enlace al archivo: el PDF sellado cuando todos han firmado, el original antes de eso. El enlace funciona durante diez minutos y no necesita clave. Es un GET, así que pon el argumento en la dirección.

request_idstringrequerido
El id que devolvió send_for_signature.

Recibes: id, ref, sealed, filename, content_type, bytes, sha256, url y expires_at. sha256 es la suma de comprobación del archivo que te da el enlace.

GET https://app.vamosign.com/v1/get_evidence

Te da todo lo que VAMOSIGN registró sobre una solicitud en un solo documento JSON, para guardarlo junto al archivo firmado: las sumas de comprobación, el código de registro, cada firmante con método, hora, dirección IP y navegador, sus respuestas y todo el registro de eventos. Es un GET, así que pon el argumento en la dirección.

request_idstringrequerido
El id que devolvió send_for_signature.

Recibes: evidence (el nombre del formato, vamosign-evidence-v1), generated_at, request, document, record, signers y events.

Cuando VAMOSIGN rechaza una llamada REST, responde con 422 y un código de error: no_signers, no_document, unknown_template, unknown_who, not_found, already_ended, not_out, link_closed, not_editable, already_on_request, purged, reminded_recently o sending_paused. En un plan que no incluye la acción, el código es tier_required, con el plan que sí la incluye y la dirección de la página del plan. Una clave faltante o revocada obtiene 401.