transaction_created Webhook
Request Body schema: application/json
Evento que se emite cuando se crea una transacción
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_created" El tipo de evento |
required | object La información del evento |
Request samples
- Payload
{- "created": "2024-02-16T17:02:20.635Z",
- "id": "clsowe02k00063ol92j9sjwdp",
- "type": "transaction_created",
- "data": {
- "id": "clsowe02i00053ol94bo3wl1q",
- "status": "draft",
- "created_by": {
- "email": "dev@autosign.io",
- "id": "clrjofqx40001raun4msulwp8"
}
}
}
transaction_started Webhook
Request Body schema: application/json
Evento que se emite cuando una transacción fue iniciada
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_started" El tipo de evento |
required | object La información del evento |
Request samples
- Payload
{- "created": "2024-02-16T17:38:55.563Z",
- "id": "clsoxp1os0004105mtsl2cg22",
- "type": "transaction_started",
- "data": {
- "started_by": {
- "id": "clrjofqx40001raun4msulwp8",
- "email": "dev@autosign.io"
}, - "id": "clsoxls930005exxdrxiuc5to",
- "status": "started"
}
}
transaction_completed Webhook
Request Body schema: application/json
Evento que se emite cuando una transacción fue completada
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_completed" El tipo de evento |
required | object La información del evento |
Request samples
- Payload
{- "created": "2024-02-16T17:12:25.144Z",
- "id": "clsowr00e000hgzu3dmmwasq5",
- "type": "transaction_completed",
- "data": {
- "id": "clsowfhnx000c3ol9gtwp3wcl",
- "status": "completed",
- "recipients": [
- {
- "email": "dev@autosign.io",
- "id": "clsowjov50000mq586zyohd3p",
- "name": "Luciano Alvarez",
- "role": "sender",
- "submitted_at": "2024-02-16T17:09:57.353Z"
}, - {
- "email": "lucianoalvarez1212@gmail.com",
- "id": "clsowjov50001mq58fn2a659u",
- "name": "Another firmante",
- "role": "signer",
- "submitted_at": "2024-02-16T17:12:22.692Z"
}
], - "sealed_documents": [
- {
- "created_at": "2024-02-16T17:12:25.125Z",
- "document": {
- "id": "clsowjaxa000g3ol9ok4ealw3",
- "name": "sample.pdf"
}, - "id": "clsowqyhy000agzu3jm80ihoh",
- "name": "sealed-sample.pdf",
}
]
}
}
transaction_expired Webhook
Request Body schema: application/json
Evento que se emite cuando una transacción fue expirada
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_expired" El tipo de evento |
required | object La información del evento |
Request samples
- Payload
{- "created": "2024-02-16T18:11:20.743Z",
- "id": "clsoyuqlm0002gjd9d0erwubq",
- "type": "transaction_expired",
- "data": {
- "id": "clsoy7hh70005bt77pasujcpy",
- "status": "expired",
- "expiration_days": null,
- "expired_at": "2024-02-16T18:11:20.736Z"
}
}
recipient_submitted Webhook
Request Body schema: application/json
Evento que se emite cuando un destinatario ha realizado las acciones necesarias en la transacción
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "recipient_submitted" El tipo de evento |
required | object |
Request samples
- Payload
{- "created": "2024-02-16T17:12:20.159Z",
- "id": "clsowqwm90001gzu3qpjfpmeh",
- "type": "recipient_submitted",
- "data": {
- "id": "clsowfhnx000c3ol9gtwp3wcl",
- "status": "started",
- "recipient": {
- "email": "lucianoalvarez1212@gmail.com",
- "id": "clsowjov50001mq58fn2a659u",
- "name": "Another firmante",
- "role": "signer",
- "submitted_at": "2024-02-16T17:12:20.159Z"
}
}
}
transaction_rejected Webhook
Request Body schema: application/json
Evento que se emite cuando un destinatario ha rechazado una transacción
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_rejected" El tipo de evento |
required | object |
Request samples
- Payload
{- "created": "2024-02-16T17:41:26.268Z",
- "id": "clsoxs9z3000s105mqswgw0im",
- "type": "transaction_rejected",
- "data": {
- "id": "clsoxls930005exxdrxiuc5to",
- "status": "rejected",
- "rejected_by": {
- "email": "lucianoalvarez1212@gmail.com",
- "id": "clsoxovjt0001vj584ds8gmmh",
- "name": "Luciano Alvarez",
- "role": "proxy"
}
}
}
transaction_cancelled Webhook
Request Body schema: application/json
Evento que se emite cuando una transacción fue cancelada por el remitente u otro usuario de la compañía
created required | string <date-time> La fecha en la que se creó el evento |
id required | string El id del evento |
type required | string Value: "transaction_cancelled" El tipo de evento |
required | object La información del evento |
Request samples
- Payload
{- "created": "2024-02-16T18:11:20.743Z",
- "id": "clsoyuqlm0002gjd9d0erwubq",
- "type": "transaction_cancelled",
- "data": {
- "id": "clsoy7hh70005bt77pasujcpy",
- "status": "expired",
- "cancelled_reason": "Campos incorrectos en el documento",
- "cancelled_at": "2024-02-16T18:11:20.736Z"
}
}
Subir archivo
Este endpoint te permite subir un archivo y obtener un token que representa dicho archivo dentro del cloud storage de autosign. El token retornado puede ser usado en otros endpoints al momento de vincular archivos con otros recursos (transacciones, plantillas) Se soportan todos los archivos con un peso máximo de 10 MB.
Request Body schema: multipart/form-datarequired
name | string Nombre del archivo |
file | string <binary> Archivo a subir. Máximo 10MB |
Responses
Response samples
- 201
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Crear transacción
Crea una transacción en estado borrador
Authorizations:
Request Body schema: application/jsonrequired
name | string Nombre de la transacción |
notification_endpoint | string or null <uri> <= 255 characters Endpoint en donde autosign enviara actualizaciones sobre la transacción (Instant Transaction Notification) |
Responses
Request samples
- Payload
{- "name": "string",
}
Response samples
- 201
{- "id": "string"
}
Actualizar campos
Actualiza los campos de los documentos de la transacción
Authorizations:
path Parameters
transactionId required | string ID de la transacción |
Request Body schema: application/jsonrequired
required | Array of objects Lista de campos | ||||||||||||||||||||||||||||||||||||||||||||||||||
Array
|
Responses
Request samples
- Payload
{- "fields": [
- {
- "document_id": "clsqnztew000arhzv2b0b5lr7",
- "page": 0,
- "height": 5.14,
- "width": 20.78,
- "positionX": 63.71,
- "positionY": 8.56,
- "type": "signature",
- "label": "Firma",
- "recipient_id": "clsqo03aw0000yq58budq7b7a",
- "id": "kqLsau9XTPwjhgkP4kISP",
- "italic": false,
- "is_required": true,
- "bold": false,
- "font_family": "roboto",
- "font_size": 14,
- "font_color": "#000000",
- "helper_text": ""
}
]
}
Actualizar transacción
Actualiza información relacionada a la transacción
Authorizations:
path Parameters
transactionId required | string ID de la transacción |
Request Body schema: application/jsonrequired
edit_navigation | boolean,null or null Configura si el usuario podrá acceder al editor previo a enviar la transacción |
required | Array of objects non-empty Documentos de la transacción |
(string or null) or string Alias que se usara en el correo de invitación de firma | |
name required | string [ 1 .. 255 ] characters Nombre de la transacción |
description | string Descripción de la transacción |
(string or null) or string Contenido se usara en el correo de invitación de firma | |
(string or null) or string Asunto se usara en el correo de invitación de firma | |
expiration_days | integer,null or null |
required | Array of objects non-empty |
Responses
Request samples
- Payload
{- "edit_navigation": true,
- "documents": [
- {
- "index": 0,
- "id": "clsqwmlwd0041lgn3c298zc5l",
- "isLoading": false
}
], - "email_alias": "",
- "name": "MY SAMPLE PDF",
- "description": "",
- "email_body": "",
- "email_subject": "",
- "recipients": [
- {
- "id": "clsqwmefn003ulgn3mkxt14fk",
- "role": "sender",
- "color": "pink",
- "index": 0,
- "name": "Luciano Alvarez",
- "email": "dev@autosign.io"
}, - {
- "id": "_-yyQ1lLsPUEx6L017xC_",
- "role": "signer",
- "color": "slate",
- "index": 1,
- "name": "Another User",
- "email": "johndoe@gmail.com"
}
], - "fields": [ ]
}
Detalle de transacción
Obtener el detalle de una transacción
Authorizations:
path Parameters
transactionId required | string ID de la transacción |
Responses
Response samples
- 200
{- "id": "clsqlgnij000fjele82l3lxz2",
- "template_id": "clsqlgnie000cjelecsv1hfrm",
- "created_at": "2024-02-17T21:32:00.901Z",
- "updated_at": "2024-02-17T21:32:00.901Z",
- "created_by_id": "clrjofqx40001raun4msulwp8",
- "sender_id": "clrjofqx40001raun4msulwp8",
- "provider_type": "onespan",
- "provider_id": null,
- "is_provider_ready": false,
- "expiration_days": null,
- "rejected_reason": null,
- "rejected_at": null,
- "rejected_by_id": null,
- "completed_at": null,
- "sent_at": null,
- "expires_at": null,
- "status": "draft",
- "company_id": "clrjofqx20000rauna08xwd42",
- "is_sealed": false,
- "is_archived": false,
- "expired_at": null,
- "template": {
- "id": "clsqlgnie000cjelecsv1hfrm",
- "name": "Plantilla de prueba onboarding Cris + INTERMEDIARIO",
- "description": "",
- "created_by_id": "clrjofqx40001raun4msulwp8",
- "edit_navigation": true,
- "reusable": false,
- "email_alias": "",
- "email_subject": "",
- "email_body": "",
- "created_at": "2024-02-17T21:32:00.901Z",
- "updated_at": "2024-02-17T21:32:12.560Z",
- "company_id": "clrjofqx20000rauna08xwd42",
- "fields": [
- {
- "id": "clsqlgwi9000kjelelrfe5usq",
- "document_id": "clrozh35o00088ry5q4uj8i3c",
- "recipient_id": "clsqlgwi40000if58145eaveg",
- "width": 28.01,
- "height": 6.34,
- "positionX": 12,
- "positionY": 49.77,
- "page": 0,
- "label": "Nombre de la persona",
- "type": "person_name",
- "template_id": "clsqlgnie000cjelecsv1hfrm",
- "font_family": "roboto",
- "bold": false,
- "italic": false,
- "underline": false,
- "font_size": 14,
- "font_color": "#000000",
- "helper_text": "",
- "is_required": false,
- "max_length": null,
- "min_length": null,
- "max_value": null,
- "min_value": null,
- "regex": null,
- "options": [ ]
}
], - "recipients": [
- {
- "id": "clsqlgwi40000if58145eaveg",
- "name": "",
- "email": "",
- "color": "stone",
- "token": null,
- "role": "sender",
- "submitted_at": null,
- "index": 0,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}, - {
- "id": "clsqlgwi40001if58f1a726yz",
- "name": "",
- "email": "",
- "color": "indigo",
- "token": null,
- "role": "signer",
- "submitted_at": null,
- "index": 1,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}, - {
- "id": "clsqlgwi40002if58fvcc47y2",
- "name": "",
- "email": "",
- "color": "zinc",
- "token": null,
- "role": "signer",
- "submitted_at": null,
- "index": 2,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}
], - "documents": [
- {
- "file": {
- "id": "clrozh35p000a8ry57o8frjiw",
- "original_name": "2020-08-27T00-35_transaccin_n._3214998911948606-6170100.pdf",
- "stored_name": "d0a67218-f103-4f4b-b10c-d42354773a77-2020-08-27t00-35_transaccin_n._3214998911948606-6170100.pdf",
}, - "status": "processed",
- "id": "clrozh35o00088ry5q4uj8i3c",
- "index": 0,
- "pages": [
- {
- "document_id": "clrozh35o00088ry5q4uj8i3c",
- "id": "clrozh5f4000sv7tnt6u7ro99",
- "file": {
- "id": "clrozh5ep000rv7tnx5nggbst",
- "original_name": "documents/clrozh35o00088ry5q4uj8i3c/0.jpeg",
- "stored_name": "documents/clrozh35o00088ry5q4uj8i3c/0.jpeg",
}
}
]
}
]
}
}
Agregar documento
Agregar un archivo previamente subido al cloud storage de autosign como documento de una transacción
Authorizations:
path Parameters
transactionId required | string ID de la transacción |
Request Body schema: application/jsonrequired
token required | string non-empty File token del archivo. Para subir un archivo al cloudstorage de autosign y obtener uno, observa la documentación sobre File |
Responses
Request samples
- Payload
{- "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Response samples
- 201
{- "id": "clsoy7hh70005bt77pasujcpy"
}
Usar plantillas
Instancia una o varias plantillas para la transacción
Authorizations:
path Parameters
transactionId required | string ID de la transacción |
Request Body schema: application/jsonrequired
required | Array of objects non-empty Lista de plantillas | ||
Array (non-empty)
|
Responses
Request samples
- Payload
{- "templates": [
- {
- "id": "cjuwz3z5z0000l3z1z3z3z3z3"
}
]
}
Response samples
- 201
{- "id": "clsqlgnij000fjele82l3lxz2",
- "template_id": "clsqlgnie000cjelecsv1hfrm",
- "created_at": "2024-02-17T21:32:00.901Z",
- "updated_at": "2024-02-17T21:32:00.901Z",
- "created_by_id": "clrjofqx40001raun4msulwp8",
- "sender_id": "clrjofqx40001raun4msulwp8",
- "provider_type": "onespan",
- "provider_id": null,
- "is_provider_ready": false,
- "expiration_days": null,
- "rejected_reason": null,
- "rejected_at": null,
- "rejected_by_id": null,
- "completed_at": null,
- "sent_at": null,
- "expires_at": null,
- "status": "draft",
- "company_id": "clrjofqx20000rauna08xwd42",
- "is_sealed": false,
- "is_archived": false,
- "expired_at": null,
- "template": {
- "id": "clsqlgnie000cjelecsv1hfrm",
- "name": "Plantilla de prueba onboarding Cris + INTERMEDIARIO",
- "description": "",
- "created_by_id": "clrjofqx40001raun4msulwp8",
- "edit_navigation": true,
- "reusable": false,
- "email_alias": "",
- "email_subject": "",
- "email_body": "",
- "created_at": "2024-02-17T21:32:00.901Z",
- "updated_at": "2024-02-17T21:32:12.560Z",
- "company_id": "clrjofqx20000rauna08xwd42",
- "fields": [
- {
- "id": "clsqlgwi9000kjelelrfe5usq",
- "document_id": "clrozh35o00088ry5q4uj8i3c",
- "recipient_id": "clsqlgwi40000if58145eaveg",
- "width": 28.01,
- "height": 6.34,
- "positionX": 12,
- "positionY": 49.77,
- "page": 0,
- "label": "Nombre de la persona",
- "type": "person_name",
- "template_id": "clsqlgnie000cjelecsv1hfrm",
- "font_family": "roboto",
- "bold": false,
- "italic": false,
- "underline": false,
- "font_size": 14,
- "font_color": "#000000",
- "helper_text": "",
- "is_required": false,
- "max_length": null,
- "min_length": null,
- "max_value": null,
- "min_value": null,
- "regex": null,
- "options": [ ]
}
], - "recipients": [
- {
- "id": "clsqlgwi40000if58145eaveg",
- "name": "",
- "email": "",
- "color": "stone",
- "token": null,
- "role": "sender",
- "submitted_at": null,
- "index": 0,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}, - {
- "id": "clsqlgwi40001if58f1a726yz",
- "name": "",
- "email": "",
- "color": "indigo",
- "token": null,
- "role": "signer",
- "submitted_at": null,
- "index": 1,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}, - {
- "id": "clsqlgwi40002if58fvcc47y2",
- "name": "",
- "email": "",
- "color": "zinc",
- "token": null,
- "role": "signer",
- "submitted_at": null,
- "index": 2,
- "is_current": false,
- "created_at": "2024-02-17T21:32:12.560Z",
- "updated_at": "2024-02-17T21:32:12.560Z"
}
], - "documents": [
- {
- "file": {
- "id": "clrozh35p000a8ry57o8frjiw",
- "original_name": "2020-08-27T00-35_transaccin_n._3214998911948606-6170100.pdf",
- "stored_name": "d0a67218-f103-4f4b-b10c-d42354773a77-2020-08-27t00-35_transaccin_n._3214998911948606-6170100.pdf",
}, - "status": "processed",
- "id": "clrozh35o00088ry5q4uj8i3c",
- "index": 0,
- "pages": [
- {
- "document_id": "clrozh35o00088ry5q4uj8i3c",
- "id": "clrozh5f4000sv7tnt6u7ro99",
- "file": {
- "id": "clrozh5ep000rv7tnx5nggbst",
- "original_name": "documents/clrozh35o00088ry5q4uj8i3c/0.jpeg",
- "stored_name": "documents/clrozh35o00088ry5q4uj8i3c/0.jpeg",
}
}
]
}
]
}
}
Listar plantillas
Lista las plantillas de transacciones
Authorizations:
query Parameters
search | string Búsqueda por nombre de plantilla |
limit required | number Cantidad de plantillas a mostrar |
page required | number Número de página |
Responses
Response samples
- 200
{- "items": [
- {
- "id": "string",
- "name": "string"
}
], - "meta": {
- "limit": 0,
- "is_first_page": true,
- "is_last_page": true,
- "current_page": 0,
- "previous_page": 0,
- "next_page": 0,
- "page_count": 0
}
}
Exchange code for access token
Request Body schema: application/jsonrequired
client_id required | string non-empty OAuth Application Client ID |
client_secret required | string non-empty OAuth Application Client Secret |
code required | string non-empty Authorization code |
Responses
Request samples
- Payload
{- "client_id": "string",
- "client_secret": "string",
- "code": "string"
}
Response samples
- default
{- "access_token": "string",
- "refresh_token": "string",
- "expires_in": 0
}
Refresh access token
Request Body schema: application/jsonrequired
client_id required | string non-empty OAuth Application Client ID |
client_secret required | string non-empty OAuth Application Client Secret |
refresh_token required | string non-empty Refresh token |
Responses
Request samples
- Payload
{- "client_id": "string",
- "client_secret": "string",
- "refresh_token": "string"
}
Response samples
- default
{- "access_token": "string",
- "expires_in": 0
}
Crear webhook
Este endpoint te permite crear un webhook
Authorizations:
Request Body schema: application/jsonrequired
name required | string [ 1 .. 255 ] characters Nombre del webhook |
endpoint required | string <uri> non-empty URL del webhook. Debe ser segura (TLS) |
events required | Array of strings non-empty Items Enum: "transaction_completed" "transaction_created" "transaction_started" "transaction_expired" "transaction_rejected" "recipient_submitted" "transaction_cancelled" La lista de eventos que deseas suscribirte |
Responses
Request samples
- Payload
{- "name": "Webhook de prueba",
- "events": [
- "transaction_created",
- "transaction_started"
]
}
Response samples
- 201
{- "id": "cjuv0v7zg0000hj6z8f0z3x4z"
}
Listar webhooks
Este endpoint te permite listar los webhooks mediante paginacion
Authorizations:
query Parameters
limit required | number Example: limit=10 Numero de elementos por pagina |
page required | number Example: page=1 Numero de pagina |
Responses
Response samples
- 200
{- "items": [
- {
- "name": "Webhook de prueba",
- "events": [
- "transaction_started",
- "transaction_completed"
], - "enabled": true,
- "id": "cjuv0v7zg0000hj6z8f0z3x4z"
}
], - "meta": {
- "limit": 10,
- "is_first_page": true,
- "is_last_page": true,
- "current_page": 1,
- "previous_page": null,
- "next_page": null,
- "page_count": 1
}
}