La API de zerosoft.
REST y JSON.
Link, CRM, Cal, Track, Docs, Chat, Agents y la mayoría de las otras apps tienen API REST con respuestas JSON y claves personales.
Base URL
https://zerosoft.ai/api/v1Autenticación
Cada request necesita una API key, enviada como Bearer token. Para sesiones de navegador, el flujo OAuth de Google crea la cookie de sesión.
Authorization: Bearer zs_live_9f3k...Creá las keys en Dashboard → Settings → API keys. La key se muestra una sola vez: copiala y guardala como una contraseña. Cada key permite 100 requests por minuto.
Cada key tiene scopes, que se eligen al crearla. Los de escritura incluyen lectura. Las keys creadas antes de los scopes tienen todos. Un request sin el scope necesario recibe 403 insufficient_scope.
| Scope | Descripción |
|---|---|
crm:read | Leer contactos, empresas, deals, actividades, tareas, pipelines, productos, cotizaciones, tags, templates, secuencias y formularios. |
crm:write | Crear, editar y borrar registros del CRM, inscribir en secuencias y etiquetar (incluye crm:read). |
links:read | Listar links y leer sus estadísticas. |
links:write | Crear, editar y borrar links cortos (incluye links:read). |
cal:read | Listar tipos de evento y reservas. |
cal:write | Crear y cancelar reservas (incluye cal:read). |
agents:run | Enviar mensajes a tus agentes de AI. |
robots:run | Listar y correr robots, y leer sus corridas y lotes. |
chat:read | Listar las conversaciones de Chat y leer sus mensajes. |
chat:write | Responder, asignar, resolver y reabrir conversaciones de Chat (incluye chat:read). |
groups:read | Leer chats, mensajes y tickets de WhatsApp en Lines. |
groups:write | Mandar mensajes de WhatsApp y crear tickets en Lines. |
voice:read | Leer dictados, reuniones y transcripciones de Voice. |
voice:write | Dictar y subir audio de reuniones a Voice. |
track:read | Leer issues y pedidos de clientes de Track. |
track:write | Crear issues de Track desde pedidos de clientes (email, formularios, Flow). |
docs:read | Leer páginas, bases, filas y comentarios de Docs, y buscar. |
docs:write | Crear y editar páginas, filas y comentarios de Docs (incluye docs:read). |
talk:read | Leer canales y mensajes de Talk donde sos miembro. |
talk:write | Publicar mensajes y crear canales en Talk. |
boards:read | Leer pizarras, su resumen y buscar adentro. |
boards:write | Crear pizarras, sumar stickies y formas, renombrarlas, moverlas y mandarlas a la papelera. |
design:read | Leer diseños de Design y sus páginas. |
shop:read | Leer productos y pedidos de Shop. |
shop:write | Crear productos de Shop. |
hiring:read | Leer los puestos de Hiring y los candidatos que ve quien creó la key. |
sign:read | Leer los sobres de Sign que ve la persona dueña de la key (sin archivos). |
analytics:read | Leer proyectos, eventos y personas de Pulse y correr consultas. |
analytics:write | Cambiar proyectos, insights, tableros, cohortes y flags de Pulse. |
bi:read | Leer preguntas, tableros y colecciones de Analytics y correr consultas. |
bi:write | Crear y cambiar preguntas, tableros, colecciones y suscripciones de Analytics. |
social:read | Leer publicaciones de Social de las cuentas que ves. |
social:write | Crear borradores y publicaciones programadas en Social (con aprobación si la necesitás). |
people:read | Leer el directorio de People: solo campos públicos de la ficha, nunca sueldo ni datos personales. |
books:read | Leer facturas de Books (con el rol de Books de quien creó la key). |
books:write | Crear facturas borrador en Books. |
forms:read | Leer los formularios de Forms y sus respuestas, solo los que puede ver quien creó la key. |
send:read | Leer los documentos que la persona ve, con sus links y visitas. |
calls:read | Leer las llamadas que la persona ve, con transcripciones y análisis. |
calls:write | Crear y editar llamadas, comentarios y clips, y mandar el notetaker a una reunión. |
notes:read | Leer las notas que puede ver quien creó la clave, y sus tareas. |
notes:write | Crear y editar las notas de quien creó la clave. |
Una key actúa como la persona que la creó: si tu workspace limita a los members a sus registros del CRM (o a los de su equipo), la API devuelve solo esos registros.
Inicio de sesión con Google
/api/auth/signin/googleRedirigí al usuario para iniciar el flujo OAuth de Google. Tras el éxito vuelve a la app con la cookie de sesión.
curl -X GET "https://zerosoft.ai/api/auth/signin/google" \
-H "Authorization: Bearer zs_live_9f3k..."Links
Crear, listar, actualizar y medir links cortos.
Crear un link
/api/v1/linksCrea un link corto con las mismas opciones que la app: UTM, vencimiento, límite de clicks, contraseña, vista previa social, segmentación y un externalId. slug es opcional: si lo omitís, generamos uno.
Scope links:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
url | string | Sí | URL de destino. |
domain | string | No | Hostname de uno de tus dominios propios verificados. Si lo omitís, se usa el dominio por defecto. |
slug | string | No | Slug corto personalizado. |
title | string | No | Título legible. |
tags | string[] | No | Array de strings de tags. |
utmSource | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmMedium | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmCampaign | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmTerm | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmContent | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
redirectType | integer | No | 302 (default) o 301. |
expiresAt | string | No | Fecha ISO 8601. Pasada esa fecha, el link redirige a expiredUrl o muestra la página de vencido. |
maxClicks | integer | No | Clicks permitidos antes de que el link deje de redirigir. |
password | string | No | La visita la tiene que escribir antes del redirect. Se guarda hasheada y nunca se devuelve; la respuesta solo dice has_password. |
ogTitle | string | No | Título, descripción e imagen (URL http(s)) de la vista previa en redes y apps de chat. |
ogDescription | string | No | Título, descripción e imagen (URL http(s)) de la vista previa en redes y apps de chat. |
ogImage | string | No | Título, descripción e imagen (URL http(s)) de la vista previa en redes y apps de chat. |
targeting | object | No | Reglas por país y dispositivo, destinos A/B con pesos y deep links de iOS/Android. null las borra. |
externalId | string | No | Tu propio id para el link, único por workspace (letras, números y . _ : @ -). Después leé o editá el link con /api/v1/links/ext_{externalId}. |
forwardParams | boolean | No | Pasa los query params del link corto al destino (default true). En conflicto gana el del link corto; qr nunca se pasa. |
doIndex | boolean | No | Permite que los buscadores indexen el link corto (default false). Sin esto el redirect lleva X-Robots-Tag: noindex. |
expiredUrl | string | No | A dónde redirige el link cuando vence o llega a max_clicks. null lo borra y se usa el default del dominio o la página de zerosoft. |
curl -X POST "https://zerosoft.ai/api/v1/links" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"url": "https://zerosoft.ai/blog/open-source-launch",
"slug": "manifesto",
"title": "The manifesto",
"tags": [
"launch",
"blog"
],
"utmSource": "newsletter",
"utmMedium": "email",
"expiresAt": "2026-12-31T23:59:00Z",
"externalId": "cms-post-4812"
}'Request
{
"url": "https://zerosoft.ai/blog/open-source-launch",
"slug": "manifesto",
"title": "The manifesto",
"tags": [
"launch",
"blog"
],
"utmSource": "newsletter",
"utmMedium": "email",
"expiresAt": "2026-12-31T23:59:00Z",
"externalId": "cms-post-4812"
}Respuesta · 201
{
"id": "lnk_9f3ka2",
"slug": "manifesto",
"domain": null,
"short_url": "https://zs.ai/manifesto",
"url": "https://zerosoft.ai/blog/open-source-launch?utm_source=newsletter&utm_medium=email",
"title": "The manifesto",
"tags": [
"launch",
"blog"
],
"archived": false,
"redirect_type": 302,
"expires_at": "2026-12-31T23:59:00.000Z",
"max_clicks": null,
"has_password": false,
"utm": {
"source": "newsletter",
"medium": "email",
"campaign": null,
"term": null,
"content": null
},
"og": {
"title": null,
"description": null,
"image": null
},
"clicks": 0,
"qr_scans": 0,
"targeting": null,
"forward_params": true,
"do_index": false,
"expired_url": null,
"created_by": "usr_4kq1",
"external_id": "cms-post-4812",
"folder_id": null,
"created_at": "2026-07-14T18:22:41Z",
"updated_at": "2026-07-14T18:22:41Z"
}Listar links
/api/v1/linksTus links, del más nuevo al más viejo. Paginá con page y pageSize (máx 50).
Scope links:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
creator | string | No | Solo los links que creó este id de usuario. |
q | string | No | Texto a buscar en el slug, la URL de destino y el título. |
tag | string | No | Solo los links con este tag. |
folder | string | No | Id de carpeta, o none para los links sin carpeta. |
archived | boolean | No | true trae solo los archivados, false solo los activos. Sin el parámetro vienen ambos. |
sort | string | No | created (por defecto, del más nuevo al más viejo) o clicks (del más clickeado al menos). |
curl -X GET "https://zerosoft.ai/api/v1/links" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"links": [
{
"id": "lnk_9f3ka2",
"slug": "manifesto",
"short_url": "https://zs.ai/manifesto",
"url": "https://zerosoft.ai/blog/open-source-launch",
"title": "The manifesto",
"tags": [
"launch",
"blog"
],
"clicks": 4812,
"archived": false,
"external_id": "cms-post-4812",
"created_by": "usr_4kq1",
"created_at": "2026-07-14T18:22:41Z"
}
],
"total": 48
}Borrar un link
/api/v1/links/{id}Borrá un link por id, junto con su historial de clicks. Quien creó la API key tiene que ser admin del workspace.
Scope links:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del link, o ext_ seguido del externalId que le pusiste al crearlo. |
curl -X DELETE "https://zerosoft.ai/api/v1/links/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Actualizar un link
/api/v1/links/{id}Actualizá cualquier campo editable de un link.
Scope links:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del link, o ext_ seguido del externalId que le pusiste al crearlo. |
url | string | No | URL de destino. |
slug | string | No | Slug corto personalizado. |
title | string | No | Título legible. |
tags | string[] | No | Array de strings de tags. |
archived | boolean | No | Flag de archivo. |
targeting | object | No | Reglas por país y dispositivo, destinos A/B con pesos y deep links de iOS/Android. null las borra. |
utmSource | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmMedium | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmCampaign | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmTerm | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
utmContent | string | No | Pone ese parámetro utm_* en la URL de destino. Un string vacío o null lo saca. El objeto utm del link siempre refleja la URL final. |
externalId | string | No | Tu propio id para el link, único por workspace (letras, números y . _ : @ -). Después leé o editá el link con /api/v1/links/ext_{externalId}. |
forwardParams | boolean | No | Pasa los query params del link corto al destino (default true). En conflicto gana el del link corto; qr nunca se pasa. |
doIndex | boolean | No | Permite que los buscadores indexen el link corto (default false). Sin esto el redirect lleva X-Robots-Tag: noindex. |
expiredUrl | string | No | A dónde redirige el link cuando vence o llega a max_clicks. null lo borra y se usa el default del dominio o la página de zerosoft. |
curl -X PATCH "https://zerosoft.ai/api/v1/links/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "The manifesto — updated"
}'Request
{
"title": "The manifesto — updated"
}Estadísticas de un link
/api/v1/links/{id}/statsTotales de clicks y el detalle por día de un link.
Scope links:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del link, o ext_ seguido del externalId que le pusiste al crearlo. |
curl -X GET "https://zerosoft.ai/api/v1/links/{id}/stats" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"slug": "manifesto",
"total": 4812,
"byDay": [
{
"date": "2026-07-15",
"count": 412
},
{
"date": "2026-07-16",
"count": 388
},
{
"date": "2026-07-17",
"count": 441
}
]
}Analytics del workspace
/api/v1/links/analyticsClics y escaneos QR de todos tus links en un rango: por día, top links, referrers, países, dispositivos y navegadores. Máximo 366 días.
Scope links:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
from | string | No | Fecha inicial (YYYY-MM-DD). Por defecto, hace 29 días. |
to | string | No | Fecha final (YYYY-MM-DD). Por defecto, hoy. |
curl -X GET "https://zerosoft.ai/api/v1/links/analytics" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"range": {
"from": "2026-07-01",
"to": "2026-07-30"
},
"timezone": "UTC",
"filters": {},
"clicks": 1840,
"scans": 212,
"previous": {
"clicks": 1502,
"scans": 160
},
"byDay": [
{
"date": "2026-07-01",
"clicks": 61,
"scans": 7
}
],
"topLinks": [
{
"id": "lnk_9f3ka2",
"slug": "manifesto",
"short_url": "https://zs.ai/manifesto",
"clicks": 912,
"scans": 88
}
],
"referrers": [
{
"name": "direct",
"count": 640
}
],
"countries": [
{
"name": "AR",
"count": 803
}
],
"devices": [
{
"name": "mobile",
"count": 1210
}
],
"browsers": [
{
"name": "Chrome",
"count": 990
}
]
}Registrar un lead
/api/v1/links/track/leadAtribuye un registro al click que trajo a la persona. El link tiene que tener activada la medición de conversiones: sus visitas llegan a tu sitio con ?zs_id=<clickId> (el script /link-tracking.js lo guarda en una cookie zs_id de tu dominio). El mismo cliente con el mismo evento cuenta una sola vez.
Scope links:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
clickId | string | Sí | Click id que llegó a tu sitio como ?zs_id= (20 letras y números). |
customerExternalId | string | Sí | Tu propio id del cliente. Las ventas que registres después con este id van al mismo link. |
eventName | string | No | Nombre del evento, como Sign up o Purchase. |
customerName | string | No | Nombre del cliente (opcional, solo lo ve tu workspace). |
customerEmail | string | No | Email del cliente (opcional, solo lo ve tu workspace). |
curl -X POST "https://zerosoft.ai/api/v1/links/track/lead" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"clickId": "Xk3mPq8ZrT2vLw9nB4cD",
"eventName": "Sign up",
"customerExternalId": "user_123"
}'Request
{
"clickId": "Xk3mPq8ZrT2vLw9nB4cD",
"eventName": "Sign up",
"customerExternalId": "user_123"
}Respuesta · 201
{
"lead": {
"id": 41,
"type": "lead",
"eventName": "Sign up",
"linkId": "lnk_9f3ka2",
"clickId": "Xk3mPq8ZrT2vLw9nB4cD",
"customerExternalId": "user_123",
"amount": 0,
"currency": null,
"source": "api"
},
"duplicate": false
}Registrar una venta
/api/v1/links/track/saleSuma ingresos al link que trajo al cliente: por customerExternalId (un lead registrado antes) o por clickId en una venta directa. Los montos van en unidades menores. Un invoiceId repetido devuelve duplicate: true y no cuenta dos veces.
Scope links:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
customerExternalId | string | No | Tu propio id del cliente. Las ventas que registres después con este id van al mismo link. |
clickId | string | No | Click id que llegó a tu sitio como ?zs_id= (20 letras y números). |
amount | integer | Sí | Monto en unidades menores (4900 = 49,00). |
currency | string | No | Código ISO 4217. Por defecto USD. |
invoiceId | string | No | Id del pago o la factura, así la misma venta nunca cuenta dos veces. |
eventName | string | No | Nombre del evento, como Sign up o Purchase. |
curl -X POST "https://zerosoft.ai/api/v1/links/track/sale" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"customerExternalId": "user_123",
"amount": 4900,
"currency": "USD",
"invoiceId": "inv_1"
}'Request
{
"customerExternalId": "user_123",
"amount": 4900,
"currency": "USD",
"invoiceId": "inv_1"
}Respuesta · 201
{
"sale": {
"id": 42,
"type": "sale",
"eventName": "Purchase",
"linkId": "lnk_9f3ka2",
"customerExternalId": "user_123",
"amount": 4900,
"currency": "USD",
"invoiceId": "inv_1",
"source": "api"
},
"duplicate": false
}Deep link diferido (apertura de la app)
/api/v1/links/track/openLo llama tu app al abrirse por primera vez con la publishable key del workspace (Authorization: Bearer zs_pk_…, en Ajustes de Link › Conversiones), nunca con una API key. Devuelve el link de este workspace que se tocó en la última hora desde la misma red y plataforma (coincidencia por un hash con sal, de un solo uso), o resuelve deepLink si la app se abrió con uno de tus links cortos. Los links con contraseña vuelven sin destino; los archivados, vencidos, bloqueados o sin clicks dan 404.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
platform | string | Sí | ios o android. |
domain | string | No | Hostname de tu dominio propio, para buscar solo links de ese dominio. |
deepLink | string | No | Link corto con el que se abrió la app (universal link o app link), si lo hay. |
curl -X POST "https://zerosoft.ai/api/v1/links/track/open" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"platform": "ios",
"domain": "go.acme.com"
}'Request
{
"platform": "ios",
"domain": "go.acme.com"
}Respuesta · 200
{
"matched": "deferred",
"clickId": null,
"link": {
"id": "lnk_9f3ka2",
"shortLink": "https://go.acme.com/app",
"url": "https://acme.com/app",
"deepLink": "acme://promo/42"
}
}Servidor MCP
/api/v1/links/mcpServidor Model Context Protocol (streamable HTTP, respuestas JSON) para agentes de IA. Herramientas: list_links, get_link, create_link, update_link, delete_link, get_link_analytics, get_analytics, list_conversions y list_activity. links:read lee, links:write crea y edita. La key actúa como la persona que la creó, con sus permisos de carpetas.
Scope links:read
curl -X POST "https://zerosoft.ai/api/v1/links/mcp" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_link",
"arguments": {
"url": "https://acme.com/launch"
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_link",
"arguments": {
"url": "https://acme.com/launch"
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"id\":\"lnk_…\",\"short_url\":\"https://zs.ai/x7k2p9q\"}"
}
],
"isError": false
}
}CRM · Contactos
Personas y leads.
Listar contactos
/api/v1/crm/contactsLista contactos. Filtros: q, page, pageSize (máx 100).
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
lifecycle | string | No | Etapa del ciclo de vida (lead, sql, opportunity, customer). |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/contacts" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"contacts": [
{
"id": "b1f47ac2-…",
"first_name": "Ana",
"last_name": "Garcia",
"email": "ana@kallpa.co",
"lifecycle_stage": "sql",
"company_id": null,
"created_at": "2026-07-18 10:04:11"
}
],
"total": 142,
"page": 1,
"pageSize": 25
}Crear un contacto
/api/v1/crm/contactsCrea un contacto nuevo.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
firstName | string | No | Nombre. |
lastName | string | No | Apellido. |
email | string | No | Dirección de email. |
lifecycleStage | string | No | Etapa del ciclo de vida (lead, sql, opportunity, customer). |
companyId | string | No | Id de la empresa vinculada. |
curl -X POST "https://zerosoft.ai/api/v1/crm/contacts" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"firstName": "Ana",
"lastName": "Garcia",
"email": "ana@kallpa.co",
"lifecycleStage": "sql"
}'Request
{
"firstName": "Ana",
"lastName": "Garcia",
"email": "ana@kallpa.co",
"lifecycleStage": "sql"
}Respuesta · 201
{
"id": "b1f47ac2-…",
"first_name": "Ana",
"last_name": "Garcia",
"email": "ana@kallpa.co",
"lifecycle_stage": "sql",
"created_at": "2026-07-18 10:04:11"
}Leer un contacto
/api/v1/crm/contacts/{id}Lee un contacto por id.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Actualizar un contacto
/api/v1/crm/contacts/{id}Actualizá cualquier propiedad de un contacto.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
firstName | string | No | Nombre. |
lifecycleStage | string | No | Etapa del ciclo de vida (lead, sql, opportunity, customer). |
companyId | string | null | No | Id de la empresa primaria. Se asocia si hace falta; la primaria anterior queda asociada. null quita la primaria. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"lifecycleStage": "opportunity"
}'Request
{
"lifecycleStage": "opportunity"
}Borrar un contacto
/api/v1/crm/contacts/{id}Borra el contacto de forma definitiva. Sus actividades quedan, sin vincular.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/contacts/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Empresas
Organizaciones y cuentas.
Listar empresas
/api/v1/crm/companiesLista empresas. Filtros: q, page, pageSize.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/companies" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"companies": [
{
"id": "c7a1…",
"name": "Norte Labs",
"domain": "nortelabs.co",
"industry": "Software"
}
],
"total": 40,
"page": 1,
"pageSize": 25
}Crear una empresa
/api/v1/crm/companiesCrea una empresa nueva.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre de la empresa. |
domain | string | No | Nombre de dominio. |
industry | string | No | Industria. |
parentCompanyId | string | null | No | Id de la empresa madre (jerarquía). null la deja en el nivel superior. Una empresa no puede ser su propia antecesora. |
curl -X POST "https://zerosoft.ai/api/v1/crm/companies" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Norte Labs",
"domain": "nortelabs.co",
"industry": "Software"
}'Request
{
"name": "Norte Labs",
"domain": "nortelabs.co",
"industry": "Software"
}Leer una empresa
/api/v1/crm/companies/{id}Lee una empresa por id.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/companies/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Actualizar una empresa
/api/v1/crm/companies/{id}Actualizá cualquier propiedad de una empresa.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
name | string | No | Nombre de la empresa. |
domain | string | No | Nombre de dominio. |
industry | string | No | Industria. |
parentCompanyId | string | null | No | Id de la empresa madre (jerarquía). null la deja en el nivel superior. Una empresa no puede ser su propia antecesora. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/companies/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"industry": "Cloud infrastructure",
"parentCompanyId": "{company_id}"
}'Request
{
"industry": "Cloud infrastructure",
"parentCompanyId": "{company_id}"
}Borrar una empresa
/api/v1/crm/companies/{id}Borra la empresa de forma definitiva. Los contactos siguen existiendo sin empresa.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/companies/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Deals
Oportunidades y pipelines.
Listar deals
/api/v1/crm/dealsLista deals. Filtro: pipelineId.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
pipelineId | string | No | Id del pipeline. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/deals" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"deals": [
{
"id": "d9e2…",
"name": "Norte Labs — New business",
"amount": 24000,
"currency": "USD",
"stage_id": "{stage_id}"
}
],
"total": 36,
"page": 1,
"pageSize": 25
}Crear un deal
/api/v1/crm/dealsCrea un deal en una etapa del pipeline.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
pipelineId | string | Sí | Id del pipeline. |
stageId | string | Sí | Id de la etapa. |
name | string | No | Nombre del deal. |
amount | number | No | Monto del deal. |
currency | string | No | Código de moneda. |
contactIds | string[] | No | IDs de los contactos a inscribir (1–500). |
companyId | string | No | Empresa primaria del deal. |
companyIds | string[] | No | Otras empresas para asociar al deal. |
curl -X POST "https://zerosoft.ai/api/v1/crm/deals" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"pipelineId": "{pipeline_id}",
"stageId": "{stage_id}",
"name": "Norte Labs — New business",
"amount": 24000,
"currency": "USD",
"contactIds": [
"{contact_id}"
],
"companyId": "{company_id}"
}'Request
{
"pipelineId": "{pipeline_id}",
"stageId": "{stage_id}",
"name": "Norte Labs — New business",
"amount": 24000,
"currency": "USD",
"contactIds": [
"{contact_id}"
],
"companyId": "{company_id}"
}Leer un deal
/api/v1/crm/deals/{id}Lee un deal por id.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/deals/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Actualizar un deal
/api/v1/crm/deals/{id}Actualizá monto, etapa o fechas.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
name | string | No | Nombre del deal. |
amount | number | No | Monto del deal. |
addContactIds | string[] | No | IDs de los contactos a inscribir (1–500). |
companyId | string | No | Empresa primaria del deal. |
amountOverride | boolean | No | true mantiene un monto manual aunque haya line items; false lo recalcula desde los line items. Editar el monto de un deal con line items lo activa. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/deals/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"amount": 28000,
"closeDate": "2026-11-30",
"amountOverride": true
}'Request
{
"amount": 28000,
"closeDate": "2026-11-30",
"amountOverride": true
}Mover un deal de etapa
/api/v1/crm/deals/{id}/moveMueve el deal a otra etapa de su pipeline. Las etapas ganado/perdido lo cierran; perdido necesita lostReason. Si la etapa pide propiedades que el deal no tiene, responde 422 missing_required con la lista; mandalas en fields para completarlas y mover en un solo llamado. Dispara deal.stage_changed (y deal.won / deal.lost).
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
stageId | string | Sí | Id de la etapa. |
lostReason | string | No | Por qué se perdió (obligatorio en etapas de perdido). |
fields | object | No | Propiedades que pide la etapa, se guardan antes de mover: amount, closeDate, ownerId, priority, source, description y custom (valores de custom fields por nombre). |
curl -X POST "https://zerosoft.ai/api/v1/crm/deals/{id}/move" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"stageId": "{stage_id}"
}'Request
{
"stageId": "{stage_id}"
}Borrar un deal
/api/v1/crm/deals/{id}Borra el deal de forma definitiva.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/deals/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Actividades
El timeline de un contacto, empresa o deal: notas, llamadas, reuniones, emails y tareas. Las reuniones agendadas en Cal aparecen acá solas.
Listar el timeline de un registro
/api/v1/crm/activitiesMás recientes primero. Pasá uno solo de contactId, companyId o dealId.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
contactId | companyId | dealId | string | Sí | El registro cuyo timeline querés. |
type | note | task | call | meeting | email | No | Tipo de actividad. |
limit | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/activities" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"activities": [
{
"id": "a12…",
"type": "meeting",
"subject": "Intro call",
"due_at": "2026-11-03 13:00:00",
"duration_min": 30,
"contact_id": "{contact_id}"
}
]
}Registrar una actividad
/api/v1/crm/activitiesRegistrá una nota, llamada, reunión o email en un registro. Las tareas tienen su propio endpoint.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
type | note | call | meeting | email | Sí | Tipo de actividad. |
subject | string | No | Asunto de la tarea. |
body | string | No | Texto libre: notas, resumen de la llamada, cuerpo del email. |
contactId | string | No | Id del contacto vinculado. |
dealId | string | No | Id del deal vinculado. |
curl -X POST "https://zerosoft.ai/api/v1/crm/activities" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"type": "call",
"subject": "Discovery call",
"body": "Budget approved for Q1.",
"durationMin": 25,
"contactId": "{contact_id}"
}'Request
{
"type": "call",
"subject": "Discovery call",
"body": "Budget approved for Q1.",
"durationMin": 25,
"contactId": "{contact_id}"
}CRM · Tareas
Actividades y seguimientos.
Listar tareas
/api/v1/crm/tasksLista tareas. bucket: overdue, today, upcoming, done.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
bucket | overdue | today | upcoming | done | No | Bucket de filtro: overdue, today, upcoming, done. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/tasks" \
-H "Authorization: Bearer zs_live_9f3k..."Crear una tarea
/api/v1/crm/tasksCrea una tarea, opcionalmente ligada a un registro.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
subject | string | Sí | Asunto de la tarea. |
dueAt | string (ISO 8601) | No | Fecha de vencimiento en formato ISO. |
contactId | string | No | Id del contacto vinculado. |
companyId | string | No | Id de la empresa vinculada. |
dealId | string | No | Id del deal vinculado. |
curl -X POST "https://zerosoft.ai/api/v1/crm/tasks" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"subject": "Follow-up call",
"dueAt": "2026-07-25T15:00:00Z",
"dealId": "{deal_id}"
}'Request
{
"subject": "Follow-up call",
"dueAt": "2026-07-25T15:00:00Z",
"dealId": "{deal_id}"
}Actualizar una tarea
/api/v1/crm/tasks/{id}Editá o completá una tarea.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
subject | string | No | Asunto de la tarea. |
done | boolean | No | Marcar como hecha. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/tasks/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"done": true
}'Request
{
"done": true
}CRM · Pipelines y etapas
Pipelines de venta y sus etapas.
Listar pipelines
/api/v1/crm/pipelinesLista pipelines con sus etapas.
Scope crm:read
curl -X GET "https://zerosoft.ai/api/v1/crm/pipelines" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"pipelines": [
{
"id": "{pipeline_id}",
"name": "Sales",
"position": 0,
"stages": [
{
"id": "{stage_id}",
"name": "Qualified",
"position": 0,
"probability": 20,
"isWon": false,
"isLost": false
},
{
"id": "{stage_id}",
"name": "Won",
"position": 5,
"probability": 100,
"isWon": true,
"isLost": false
}
]
}
]
}CRM · Productos y line items
Catálogo de productos y los line items de cada deal. Mientras un deal tenga line items, su monto es la suma de los netos (después del descuento, antes de impuestos), salvo que amountOverride esté activo.
Listar productos
/api/v1/crm/productsProductos del catálogo, primero los activos, ordenados por nombre.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Buscar por nombre o SKU. |
active | boolean | No | true = solo activos, false = solo archivados. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/products" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"products": [
{
"id": "{product_id}",
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"price": 1200,
"currency": "USD",
"recurring": "yearly",
"tax_pct": 21,
"active": 1,
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}
],
"total": 12,
"page": 1,
"pageSize": 25
}Crear un producto
/api/v1/crm/productsAgrega un producto al catálogo. Sin moneda, usa la moneda base del workspace.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre del producto. |
sku | string | No | SKU o código interno. |
description | string | No | Descripción que se muestra en line items y cotizaciones. |
price | number | No | Precio unitario. |
currency | string | No | Código de moneda ISO (por defecto, la moneda base del workspace). |
recurring | none | monthly | yearly | No | Facturación: none, monthly o yearly. |
taxPct | number | No | Porcentaje de impuesto (0-100). |
active | boolean | No | false archiva el producto (no aparece en los selectores). |
curl -X POST "https://zerosoft.ai/api/v1/crm/products" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Pro plan",
"sku": "PRO-Y",
"price": 1200,
"currency": "USD",
"recurring": "yearly",
"taxPct": 21
}'Request
{
"name": "Pro plan",
"sku": "PRO-Y",
"price": 1200,
"currency": "USD",
"recurring": "yearly",
"taxPct": 21
}Respuesta · 201
{
"id": "{product_id}",
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"price": 1200,
"currency": "USD",
"recurring": "yearly",
"tax_pct": 21,
"active": 1,
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}Obtener un producto
/api/v1/crm/products/{id}Devuelve un producto.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/products/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{product_id}",
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"price": 1200,
"currency": "USD",
"recurring": "yearly",
"tax_pct": 21,
"active": 1,
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}Actualizar un producto
/api/v1/crm/products/{id}Actualiza los campos que mandes. Los line items que ya están en deals no cambian.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
price | number | No | Precio unitario. |
active | boolean | No | false archiva el producto (no aparece en los selectores). |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/products/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"price": 1320,
"active": true
}'Request
{
"price": 1320,
"active": true
}Eliminar un producto
/api/v1/crm/products/{id}Elimina el producto. Los line items que lo usaban quedan en sus deals como ítems custom.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/products/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Listar los line items de un deal
/api/v1/crm/deals/{id}/line-itemsLine items con subtotal, descuento, neto, impuesto y total calculados, más los totales del deal. Los montos se redondean por línea a la moneda del deal.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del deal. |
curl -X GET "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"currency": "USD",
"items": [
{
"id": "{line_item_id}",
"deal_id": "{deal_id}",
"product_id": "{product_id}",
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"quantity": 2,
"unit_price": 1200,
"discount_pct": 10,
"tax_pct": 21,
"recurring": "yearly",
"position": 0,
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6,
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}
],
"totals": {
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6
},
"amountOverride": false
}Agregar un line item
/api/v1/crm/deals/{id}/line-itemsDesde un producto (copia nombre, precio, impuesto y recurrencia; el precio se convierte a la moneda del deal si hay tipo de cambio) o custom (nombre y unitPrice). Recalcula el monto del deal.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del deal. |
productId | string | No | Id del producto del catálogo. Omitilo para un line item custom. |
name | string | No | Nombre del line item (obligatorio en ítems custom). |
quantity | number | No | Cantidad (puede tener decimales). |
unitPrice | number | No | Precio unitario en la moneda del deal. |
discountPct | number | No | Porcentaje de descuento (0-100). |
taxPct | number | No | Porcentaje de impuesto (0-100). |
curl -X POST "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"productId": "{product_id}",
"quantity": 2,
"discountPct": 10
}'Request
{
"productId": "{product_id}",
"quantity": 2,
"discountPct": 10
}Respuesta · 201
{
"id": "{line_item_id}",
"deal_id": "{deal_id}",
"product_id": "{product_id}",
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"quantity": 2,
"unit_price": 1200,
"discount_pct": 10,
"tax_pct": 21,
"recurring": "yearly",
"position": 0,
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6,
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}Actualizar un line item
/api/v1/crm/deals/{id}/line-items/{itemId}Actualiza cantidad, precio, descuento, impuesto o texto y recalcula el monto del deal.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del deal. |
itemId | string | Sí | Id del line item. |
quantity | number | No | Cantidad (puede tener decimales). |
discountPct | number | No | Porcentaje de descuento (0-100). |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items/{itemId}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"quantity": 3,
"discountPct": 15
}'Request
{
"quantity": 3,
"discountPct": 15
}Eliminar un line item
/api/v1/crm/deals/{id}/line-items/{itemId}Quita el line item y recalcula el monto del deal.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del deal. |
itemId | string | Sí | Id del line item. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/deals/{id}/line-items/{itemId}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Cotizaciones
Cotizaciones creadas desde los line items de un deal. Cada una guarda una copia de los ítems y tiene una página pública (public_url) donde el cliente acepta o rechaza. Al aceptar se dispara el evento de Flow quote.accepted y el trigger de workflow quote_accepted.
Listar cotizaciones
/api/v1/crm/quotesCotizaciones del workspace, de la más nueva a la más vieja. Las enviadas que pasaron su vencimiento vuelven como expired.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
dealId | string | No | Solo las cotizaciones de este deal. |
status | draft | sent | accepted | declined | expired | No | Filtrar por estado. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/quotes" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"quotes": [
{
"id": "{quote_id}",
"deal_id": "{deal_id}",
"deal_name": "Norte Labs — New business",
"number": "Q-2026-0003",
"title": "Norte Labs — Pro plan",
"status": "draft",
"currency": "USD",
"items": [
{
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"quantity": 2,
"unit_price": 1200,
"discount_pct": 10,
"tax_pct": 21,
"recurring": "yearly",
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6
}
],
"subtotal": 2400,
"discount_total": 240,
"tax_total": 453.6,
"total": 2613.6,
"expires_at": "2026-11-30",
"terms": "Payment within 30 days of acceptance.",
"notes": "",
"sender_name": "Lucía Pérez",
"sender_email": "lucia@zerosoft.ai",
"sender_company": "Zerosoft",
"recipient_name": "Ana Garcia",
"recipient_email": "ana@nortelabs.co",
"recipient_company": "Norte Labs",
"sent_at": null,
"accepted_at": null,
"declined_at": null,
"signer_name": "",
"public_url": "https://zerosoft.ai/q/7Jx2kQ…",
"created_at": "2026-10-13 12:00:00"
}
],
"total": 3,
"page": 1,
"pageSize": 25
}Crear una cotización
/api/v1/crm/quotesCrea una cotización en borrador con los line items actuales del deal (necesita al menos uno). Por defecto vence en 30 días y el destinatario es el primer contacto y la empresa primaria del deal.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
dealId | string | Sí | Deal cuyos line items arman la cotización. |
title | string | No | Título de la cotización (por defecto, el nombre del deal). |
expiresAt | string | No | Fecha de vencimiento, YYYY-MM-DD. |
terms | string | No | Términos y condiciones. |
notes | string | No | Notas para el cliente. |
senderName | string | No | Datos del remitente que se muestran en la cotización. |
senderEmail | string | No | Datos del remitente que se muestran en la cotización. |
senderCompany | string | No | Datos del remitente que se muestran en la cotización. |
recipientName | string | No | Datos del destinatario (por defecto: primer contacto y empresa primaria del deal). |
recipientEmail | string | No | Datos del destinatario (por defecto: primer contacto y empresa primaria del deal). |
recipientCompany | string | No | Datos del destinatario (por defecto: primer contacto y empresa primaria del deal). |
curl -X POST "https://zerosoft.ai/api/v1/crm/quotes" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"dealId": "{deal_id}",
"title": "Norte Labs — Pro plan",
"expiresAt": "2026-11-30",
"terms": "Payment within 30 days of acceptance.",
"senderName": "Lucía Pérez",
"senderEmail": "lucia@zerosoft.ai",
"senderCompany": "Zerosoft"
}'Request
{
"dealId": "{deal_id}",
"title": "Norte Labs — Pro plan",
"expiresAt": "2026-11-30",
"terms": "Payment within 30 days of acceptance.",
"senderName": "Lucía Pérez",
"senderEmail": "lucia@zerosoft.ai",
"senderCompany": "Zerosoft"
}Respuesta · 201
{
"id": "{quote_id}",
"deal_id": "{deal_id}",
"deal_name": "Norte Labs — New business",
"number": "Q-2026-0003",
"title": "Norte Labs — Pro plan",
"status": "draft",
"currency": "USD",
"items": [
{
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"quantity": 2,
"unit_price": 1200,
"discount_pct": 10,
"tax_pct": 21,
"recurring": "yearly",
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6
}
],
"subtotal": 2400,
"discount_total": 240,
"tax_total": 453.6,
"total": 2613.6,
"expires_at": "2026-11-30",
"terms": "Payment within 30 days of acceptance.",
"notes": "",
"sender_name": "Lucía Pérez",
"sender_email": "lucia@zerosoft.ai",
"sender_company": "Zerosoft",
"recipient_name": "Ana Garcia",
"recipient_email": "ana@nortelabs.co",
"recipient_company": "Norte Labs",
"sent_at": null,
"accepted_at": null,
"declined_at": null,
"signer_name": "",
"public_url": "https://zerosoft.ai/q/7Jx2kQ…",
"created_at": "2026-10-13 12:00:00"
}Obtener una cotización
/api/v1/crm/quotes/{id}Devuelve la cotización con sus ítems y public_url.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/quotes/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{quote_id}",
"deal_id": "{deal_id}",
"deal_name": "Norte Labs — New business",
"number": "Q-2026-0003",
"title": "Norte Labs — Pro plan",
"status": "draft",
"currency": "USD",
"items": [
{
"name": "Pro plan",
"sku": "PRO-Y",
"description": "",
"quantity": 2,
"unit_price": 1200,
"discount_pct": 10,
"tax_pct": 21,
"recurring": "yearly",
"subtotal": 2400,
"discount": 240,
"net": 2160,
"tax": 453.6,
"total": 2613.6
}
],
"subtotal": 2400,
"discount_total": 240,
"tax_total": 453.6,
"total": 2613.6,
"expires_at": "2026-11-30",
"terms": "Payment within 30 days of acceptance.",
"notes": "",
"sender_name": "Lucía Pérez",
"sender_email": "lucia@zerosoft.ai",
"sender_company": "Zerosoft",
"recipient_name": "Ana Garcia",
"recipient_email": "ana@nortelabs.co",
"recipient_company": "Norte Labs",
"sent_at": null,
"accepted_at": null,
"declined_at": null,
"signer_name": "",
"public_url": "https://zerosoft.ai/q/7Jx2kQ…",
"created_at": "2026-10-13 12:00:00"
}Editar o enviar una cotización
/api/v1/crm/quotes/{id}Edita un borrador. status: "sent" publica el link público (draft → sent). Aceptar y rechazar se hace en la página pública. Si no es borrador responde 409 not_draft.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
status | string | No | "sent" publica la cotización. |
refreshItems | boolean | No | Vuelve a copiar los line items actuales del deal (solo borradores). |
expiresAt | string | No | Fecha de vencimiento, YYYY-MM-DD. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/quotes/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"refreshItems": true,
"status": "sent"
}'Request
{
"refreshItems": true,
"status": "sent"
}CRM · Leads
Los leads son prospectos antes de ser un deal: owner, etapa del pipeline de leads, contacto y empresa. Convertir un lead crea un deal desde la app. Los campos propios de leads van en custom; los que la key no puede editar devuelven 403 field_readonly y los ocultos no vienen en las respuestas.
Listar leads
/api/v1/crm/leadsLos leads que ve la key, los más nuevos primero.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
status | open | qualified | disqualified | No | Solo leads en etapas de este tipo. |
stageId | string | No | Etapa del pipeline de leads. |
contactId | string | No | Contacto asociado. |
companyId | string | No | Empresa asociada. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/leads" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"leads": [
{
"id": "f1c2…",
"owner_id": "usr_…",
"name": "Ana Gómez",
"stage_id": "stg_…",
"stage_name": "Connected",
"stage_kind": "open",
"contact_id": "c7a1…",
"company_id": "co_…",
"source": "form",
"disqualify_reason": "",
"deal_id": null,
"converted_at": null,
"custom": "{}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 25
}Crear un lead
/api/v1/crm/leadsNecesita nombre, contacto o empresa. Sin nombre toma el del contacto (o el de la empresa). Sin stageId arranca en la primera etapa abierta.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | No | Nombre del lead. |
contactId | string | No | Contacto asociado. |
companyId | string | No | Empresa asociada. |
stageId | string | No | Etapa del pipeline de leads. |
ownerId | string | No | Persona del workspace responsable. Por defecto, quien creó la key. |
source | string | No | Fuente (organic, referral, ads, social, email, event, form, other). |
custom | object | No | Campos propios de leads. |
curl -X POST "https://zerosoft.ai/api/v1/crm/leads" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"contactId": "{contact_id}",
"source": "form"
}'Request
{
"contactId": "{contact_id}",
"source": "form"
}Respuesta · 201
{
"id": "f1c2…",
"owner_id": "usr_…",
"name": "Ana Gómez",
"stage_id": "stg_…",
"stage_name": "Connected",
"stage_kind": "open",
"contact_id": "c7a1…",
"company_id": "co_…",
"source": "form",
"disqualify_reason": "",
"deal_id": null,
"converted_at": null,
"custom": "{}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}Ver un lead
/api/v1/crm/leads/{id}Un lead con su etapa, contacto, empresa y deal.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/leads/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "f1c2…",
"owner_id": "usr_…",
"name": "Ana Gómez",
"stage_id": "stg_…",
"stage_name": "Connected",
"stage_kind": "open",
"contact_id": "c7a1…",
"company_id": "co_…",
"source": "form",
"disqualify_reason": "",
"deal_id": null,
"converted_at": null,
"custom": "{}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}Editar un lead
/api/v1/crm/leads/{id}Cambia etapa, owner, contacto, empresa, fuente, motivo de descalificación o campos propios.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
stageId | string | No | Etapa del pipeline de leads. |
disqualifyReason | string | No | Por qué se descalificó el lead. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/leads/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"stageId": "{stage_id}"
}'Request
{
"stageId": "{stage_id}"
}Respuesta · 200
{
"id": "f1c2…",
"owner_id": "usr_…",
"name": "Ana Gómez",
"stage_id": "stg_…",
"stage_name": "Connected",
"stage_kind": "open",
"contact_id": "c7a1…",
"company_id": "co_…",
"source": "form",
"disqualify_reason": "",
"deal_id": null,
"converted_at": null,
"custom": "{}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}Borrar un lead
/api/v1/crm/leads/{id}Borra el lead con sus notas y tareas. El contacto, la empresa y el deal quedan.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/leads/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Objetos propios
Registros de los objetos propios que definió un admin (por ejemplo vehículos o propiedades). Cada registro tiene nombre (la propiedad primaria), owner y sus propiedades en custom. Los permisos por campo aplican como en contactos.
Listar objetos propios
/api/v1/crm/objectsLos objetos del workspace con las propiedades que ve la key.
Scope crm:read
curl -X GET "https://zerosoft.ai/api/v1/crm/objects" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"objects": [
{
"id": "obj_…",
"slug": "vehicles",
"singular": "Vehicle",
"plural": "Vehicles",
"primary_label": "Plate",
"properties": [
{
"name": "model",
"label": "Model",
"type": "text",
"options": [],
"readOnly": false
}
]
}
]
}Listar registros
/api/v1/crm/objects/{slug}/recordsLos registros de un objeto, los más nuevos primero.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
slug | string | Sí | Slug del objeto (de Listar objetos propios). |
q | string | No | Query de búsqueda. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/objects/{slug}/records" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"records": [
{
"id": "rec_…",
"object_id": "obj_…",
"owner_id": "usr_…",
"name": "AB 123 CD",
"custom": "{\"model\":\"Hilux\",\"year\":2023}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}
],
"total": 1,
"page": 1,
"pageSize": 25
}Crear un registro
/api/v1/crm/objects/{slug}/recordsLos valores de custom se validan con el tipo de cada propiedad; las propiedades que no existen se ignoran.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
slug | string | Sí | Slug del objeto (de Listar objetos propios). |
name | string | Sí | Valor de la propiedad primaria. |
ownerId | string | No | Persona del workspace responsable. Por defecto, quien creó la key. |
custom | object | No | Valores de las propiedades por nombre. |
curl -X POST "https://zerosoft.ai/api/v1/crm/objects/{slug}/records" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "AB 123 CD",
"custom": {
"model": "Hilux",
"year": 2023
}
}'Request
{
"name": "AB 123 CD",
"custom": {
"model": "Hilux",
"year": 2023
}
}Respuesta · 201
{
"id": "rec_…",
"object_id": "obj_…",
"owner_id": "usr_…",
"name": "AB 123 CD",
"custom": "{\"model\":\"Hilux\",\"year\":2023}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}Ver un registro
/api/v1/crm/objects/{slug}/records/{id}El registro con los ids de sus contactos, empresas y deals asociados.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
slug | string | Sí | Slug del objeto (de Listar objetos propios). |
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "rec_…",
"object_id": "obj_…",
"owner_id": "usr_…",
"name": "AB 123 CD",
"custom": "{\"model\":\"Hilux\",\"year\":2023}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00",
"associations": {
"contacts": [
"c7a1…"
],
"companies": [],
"deals": []
}
}Editar un registro
/api/v1/crm/objects/{slug}/records/{id}Cambia nombre, owner o propiedades.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
slug | string | Sí | Slug del objeto (de Listar objetos propios). |
id | string | Sí | Id del registro. |
custom | object | No | Valores de las propiedades por nombre. |
curl -X PATCH "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"custom": {
"model": "Hilux",
"year": 2024
}
}'Request
{
"custom": {
"model": "Hilux",
"year": 2024
}
}Respuesta · 200
{
"id": "rec_…",
"object_id": "obj_…",
"owner_id": "usr_…",
"name": "AB 123 CD",
"custom": "{\"model\":\"Hilux\",\"year\":2023}",
"created_at": "2026-10-24 12:00:00",
"updated_at": "2026-10-24 12:00:00"
}Borrar un registro
/api/v1/crm/objects/{slug}/records/{id}Borra el registro con sus notas y tareas.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
slug | string | Sí | Slug del objeto (de Listar objetos propios). |
id | string | Sí | Id del registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/objects/{slug}/records/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Asociaciones
Vínculos muchos a muchos entre contactos, empresas y deals. Un contacto o un deal puede tener varias empresas; una es la primaria. contact.company_id siempre refleja la empresa primaria.
Listar asociaciones
/api/v1/crm/associationsTodos los registros vinculados a un contacto, empresa o deal. Las empresas también devuelven su empresa madre y sus filiales.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
type | contact | company | deal | Sí | Tipo de registro: contact, company o deal. |
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/associations" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"companies": [
{
"id": "{company_id}",
"name": "Norte Labs",
"domain": "nortelabs.co",
"is_primary": true,
"label": "decision_maker"
},
{
"id": "{company_id}",
"name": "Norte Holding",
"domain": "norte.com",
"is_primary": false,
"label": "billing"
}
],
"deals": [
{
"id": "{deal_id}",
"name": "Norte Labs — New business",
"amount": 24000,
"currency": "USD"
}
]
}Asociar dos registros
/api/v1/crm/associationsVincula contacto ↔ empresa, deal ↔ empresa o deal ↔ contacto (en cualquier orden). primary la vuelve empresa primaria; label solo aplica a contacto ↔ empresa. Si la asociación ya existe, actualiza primaria y label.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
fromType | contact | company | deal | Sí | Tipo del primer registro. |
fromId | string | Sí | Id del primer registro. |
toType | contact | company | deal | Sí | Tipo del segundo registro. |
toId | string | Sí | Id del segundo registro. |
primary | boolean | No | La vuelve la empresa primaria del contacto o deal. |
label | string | No | Label de contacto ↔ empresa: employee, decision_maker, billing, champion, influencer, former_employee (o vacío). |
curl -X POST "https://zerosoft.ai/api/v1/crm/associations" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"fromType": "contact",
"fromId": "{contact_id}",
"toType": "company",
"toId": "{company_id}",
"primary": true,
"label": "decision_maker"
}'Request
{
"fromType": "contact",
"fromId": "{contact_id}",
"toType": "company",
"toId": "{company_id}",
"primary": true,
"label": "decision_maker"
}Respuesta · 201
{
"ok": true
}Quitar una asociación
/api/v1/crm/associationsDesvincula dos registros (parámetros en la query). Si quitás la empresa primaria, pasa a primaria la más antigua que quede.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
fromType | contact | company | deal | Sí | Tipo del primer registro. |
fromId | string | Sí | Id del primer registro. |
toType | contact | company | deal | Sí | Tipo del segundo registro. |
toId | string | Sí | Id del segundo registro. |
curl -X DELETE "https://zerosoft.ai/api/v1/crm/associations" \
-H "Authorization: Bearer zs_live_9f3k..."CRM · Formularios
Formularios de captura de leads y sus envíos. Cada envío también crea o actualiza un contacto y registra una actividad "Form submitted".
Listar formularios
/api/v1/crm/formsFormularios del más nuevo al más viejo, con estado, cantidad de respuestas y parciales, última respuesta y quién puede abrirlos.
Scope crm:read
curl -X GET "https://zerosoft.ai/api/v1/crm/forms" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"forms": [
{
"id": "{form_id}",
"name": "Contact us",
"key": "contact-us",
"slug": "contact-us",
"token": "a1b2c3d4e5f6a7b8c9d0",
"status": "active",
"fields": [
{
"id": "email",
"type": "email",
"label": "Email",
"property": "email",
"required": true
}
],
"submission_count": 42
}
]
}Listar envíos de un formulario
/api/v1/crm/forms/{id}/submissionsEnvíos de un formulario, los más recientes primero, con los valores, los parámetros UTM y el contacto vinculado.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/crm/forms/{id}/submissions" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"submissions": [
{
"id": "{submission_id}",
"formId": "{form_id}",
"contactId": "{contact_id}",
"contactCreated": true,
"values": {
"email": "ana@kallpa.co",
"first_name": "Ana"
},
"utm": {
"utm_source": "google",
"utm_campaign": "spring"
},
"pageUrl": "https://kallpa.co/pricing?utm_source=google",
"referrer": "",
"createdAt": "2026-10-13 14:02:11"
}
],
"total": 1,
"page": 1,
"pageSize": 25
}CRM · Templates de email y secuencias
Templates y snippets de email compartidos, y secuencias de ventas de varios pasos. Los emails de las secuencias salen del Gmail conectado de quien envía; los pasos corren con el programador de cada hora.
Listar templates de email
/api/v1/crm/email-templatesTemplates y snippets compartidos en el workspace. Las variables van entre llaves dobles (contact.first_name, contact.company, deal.name, owner.first_name, contact.custom.x), con un valor por defecto opcional después de una barra vertical.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
kind | template | snippet | No | Filtrar por tipo: template o snippet. |
curl -X GET "https://zerosoft.ai/api/v1/crm/email-templates" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"templates": [
{
"id": "{template_id}",
"kind": "template",
"name": "Intro",
"subject": "Quick question, {{contact.first_name}}",
"body": "Hi {{contact.first_name | there}}, I saw {{contact.company}} is hiring…",
"created_by": "u_123",
"created_at": "2026-10-13 12:00:00",
"updated_at": "2026-10-13 12:00:00"
}
]
}Obtener un template de email
/api/v1/crm/email-templates/{id}Devuelve un template o snippet.
Scope crm:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/crm/email-templates/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Listar secuencias
/api/v1/crm/sequencesSecuencias con su cantidad de pasos e inscripciones.
Scope crm:read
curl -X GET "https://zerosoft.ai/api/v1/crm/sequences" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"sequences": [
{
"id": "{sequence_id}",
"name": "Outbound — 3 touches",
"timezone": "America/Argentina/Buenos_Aires",
"window_start": "09:00",
"window_end": "17:00",
"business_days": 1,
"step_count": 4,
"active_count": 12,
"total_count": 40
}
]
}Inscribir contactos en una secuencia
/api/v1/crm/sequences/{id}/enrollInscribe hasta 500 contactos. Los que ya están inscriptos, se dieron de baja o no tienen email vuelven en skipped. Quien envía necesita Gmail conectado con permiso de envío.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
contactIds | string[] | Sí | IDs de los contactos a inscribir (1–500). |
senderId | string | No | Miembro del workspace cuyo Gmail envía los emails. Por defecto, el owner del contacto y si no quien creó la secuencia. |
curl -X POST "https://zerosoft.ai/api/v1/crm/sequences/{id}/enroll" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"contactIds": [
"{contact_id}"
]
}'Request
{
"contactIds": [
"{contact_id}"
]
}Respuesta · 201
{
"enrolled": [
"{contact_id}"
],
"skipped": []
}Sacar un contacto de una secuencia
/api/v1/crm/sequences/{id}/unenrollSaca al contacto de la secuencia (estado exited, motivo manual).
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
contactId | string | Sí | Id del contacto vinculado. |
curl -X POST "https://zerosoft.ai/api/v1/crm/sequences/{id}/unenroll" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"contactId": "{contact_id}"
}'Request
{
"contactId": "{contact_id}"
}Respuesta · 200
{
"exited": 1
}Registrar un email de Gmail
/api/v1/crm/extension/log-emailGuarda un email en el timeline de los contactos que participan. Mandar el mismo messageId otra vez no lo duplica (200 con duplicate: true). 404 no_contact si ningún participante es contacto.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
messageId | string | Sí | Id del mensaje en Gmail (data-legacy-message-id) |
from | string | Sí | Remitente, como "Ana <ana@acme.com>" |
to | string | No | Destinatarios, separados por comas |
subject | string | No | Asunto del email |
body | string | No | Cuerpo en texto plano |
curl -X POST "https://zerosoft.ai/api/v1/crm/extension/log-email" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"messageId": "18c2f0a1b2c3d4e5",
"from": "Ana <ana@acme.com>",
"to": "you@yourco.com",
"subject": "Pricing",
"body": "Hi…"
}'Request
{
"messageId": "18c2f0a1b2c3d4e5",
"from": "Ana <ana@acme.com>",
"to": "you@yourco.com",
"subject": "Pricing",
"body": "Hi…"
}Respuesta · 201
{
"ok": true,
"emailId": "{email_id}",
"contactIds": [
"{contact_id}"
],
"duplicate": false
}Registrar y trackear un email antes de enviarlo
/api/v1/crm/extension/trackGuarda el email saliente y devuelve el pixel de aperturas para agregar al cuerpo. Si ningún destinatario es contacto, se crea el primero.
Scope crm:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
to | string | Sí | Destinatarios, separados por comas |
subject | string | No | Asunto del email |
body | string | No | Cuerpo en texto plano |
curl -X POST "https://zerosoft.ai/api/v1/crm/extension/track" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"to": "ana@acme.com",
"subject": "Proposal",
"body": "Hi Ana…"
}'Request
{
"to": "ana@acme.com",
"subject": "Proposal",
"body": "Hi Ana…"
}Respuesta · 201
{
"ok": true,
"emailId": "{email_id}",
"pixelUrl": "https://zerosoft.ai/api/crm/t/o/{token}.gif",
"contactIds": [
"{contact_id}"
],
"createdContact": false
}Cal
Tipos de evento y reservas. Las reservas creadas por API siguen las mismas reglas que la página pública (disponibilidad, márgenes, ocupado en Google Calendar) y mandan los mismos emails.
Listar tipos de evento
/api/v1/calendar/event-typesTus tipos de evento con su URL pública de reserva.
Scope cal:read
curl -X GET "https://zerosoft.ai/api/v1/calendar/event-types" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"eventTypes": [
{
"id": "et_42",
"slug": "intro",
"title": "Intro call",
"durationMin": 30,
"active": true,
"url": "https://zerosoft.ai/en/book/ana/intro"
}
]
}Listar reservas
/api/v1/calendar/bookingsReservas de tus tipos de evento, más nuevas primero. Filtrá por estado y rango de fechas.
Scope cal:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
status | confirmed | cancelled | no_show | pending | No | Solo reservas con este estado. |
q | string | No | Busca en el nombre o el email del invitado. |
from | ISO 8601 | No | Inicio desde (inclusive). |
to | ISO 8601 | No | Inicio hasta (inclusive). |
curl -X GET "https://zerosoft.ai/api/v1/calendar/bookings" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"bookings": [
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}
]
}Crear una reserva
/api/v1/calendar/bookingsReserva un horario para un invitado. Devuelve 409 slot_unavailable si ese horario ya no se ofrece.
Scope cal:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
eventTypeId | string | Sí | Id del tipo de evento (de Listar tipos de evento). |
start | ISO 8601 | Sí | Inicio del horario; tiene que coincidir con uno ofrecido. |
name | string | Sí | Nombre del invitado. |
email | string | Sí | Email del invitado: recibe la confirmación y la invitación de calendario. |
timezone | IANA | No | Zona horaria del invitado para los emails. Por defecto UTC. |
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"eventTypeId": "et_42",
"start": "2026-11-03T13:00:00.000Z",
"name": "Ana",
"email": "ana@example.com",
"timezone": "America/Argentina/Buenos_Aires"
}'Request
{
"eventTypeId": "et_42",
"start": "2026-11-03T13:00:00.000Z",
"name": "Ana",
"email": "ana@example.com",
"timezone": "America/Argentina/Buenos_Aires"
}Respuesta · 201
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}Obtener una reserva
/api/v1/calendar/bookings/:idUna reserva por id (dueño del tipo de evento o host asignado).
Scope cal:read
curl -X GET "https://zerosoft.ai/api/v1/calendar/bookings/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}Cancelar una reserva
/api/v1/calendar/bookings/:id/cancelCancela una reserva confirmada, le manda al invitado la cancelación con .ics, borra el evento de Google Calendar y emite booking.cancelled.
Scope cal:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
reason | string | No | Se le muestra al invitado en el email de cancelación. |
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/cancel" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"reason": "Customer asked to move it to next month"
}'Request
{
"reason": "Customer asked to move it to next month"
}Respuesta · 200
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "cancelled",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": "Customer asked to move it to next month",
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}Reprogramar una reserva
/api/v1/calendar/bookings/:id/rescheduleMueve una reserva confirmada a otro horario ofrecido, le manda al invitado el .ics actualizado y emite booking.rescheduled. Devuelve 409 slot_unavailable si el horario no se ofrece.
Scope cal:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
start | ISO 8601 | Sí | Inicio del horario; tiene que coincidir con uno ofrecido. |
timezone | IANA | No | Zona horaria del invitado para los emails. Por defecto UTC. |
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/reschedule" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"start": "2026-11-04T14:00:00.000Z"
}'Request
{
"start": "2026-11-04T14:00:00.000Z"
}Respuesta · 200
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-04T14:00:00.000Z",
"endsAt": "2026-11-04T14:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}Marcar inasistencia
/api/v1/calendar/bookings/:id/no-showMarca que el invitado no se presentó. Solo para reservas confirmadas.
Scope cal:write
curl -X POST "https://zerosoft.ai/api/v1/calendar/bookings/:id/no-show" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "no_show",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}Agents
Hablá con tus agentes de AI desde tu propia app. El agente usa las mismas instrucciones, conocimiento y herramientas que en Chat y en su página pública; cada respuesta cuenta para la cuota de AI del workspace.
Enviar un mensaje a un agente
/api/v1/agents/:id/messagesDevuelve la respuesta del agente y las herramientas que usó. Mandá el conversationId devuelto para seguir la misma conversación. Errores: 404 not_found, 403 agent_disabled, 429 rate_limited, 503 ai_disabled.
Scope agents:run
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
message | string | Sí | Lo que dice el usuario (hasta 4000 caracteres). |
conversationId | string | No | Continúa una conversación de API existente. Omitilo para empezar una nueva. |
curl -X POST "https://zerosoft.ai/api/v1/agents/:id/messages" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"message": "Do you ship to Brazil?"
}'Request
{
"message": "Do you ship to Brazil?"
}Respuesta · 200
{
"conversationId": "6b0f8f7e-2a43-4d0c-9a51-3f3c1f1b8e21",
"message": {
"id": "b7e1…",
"role": "assistant",
"content": "Yes! We ship to Brazil in 5–7 business days.",
"createdAt": "2026-11-01T18:00:00.000Z"
},
"status": "replied",
"handoff": false,
"toolCalls": [
{
"tool": "search_knowledge",
"input": {
"query": "shipping Brazil"
},
"output": {
"results": []
},
"error": null
}
]
}Chat
Leé y respondé las conversaciones del inbox de Chat desde tu app o tu helpdesk. Necesita el scope chat:read para leer y chat:write para responder, asignar y resolver. Las respuestas salen a nombre de quien creó la key.
Listar conversaciones
/api/v1/chat/conversationsConversaciones de los widgets del workspace, las actualizadas más recientemente primero.
Scope chat:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
status | open | pending | snoozed | resolved | No | Solo conversaciones con este estado. |
assignedTo | string | No | Solo conversaciones asignadas a este id de usuario, o unassigned. |
widgetId | string | No | Solo conversaciones de este widget. |
limit | integer | No | Cuántas devolver (de 1 a 200, 50 por defecto). |
offset | integer | No | Cuántas saltear, para paginar. |
curl -X GET "https://zerosoft.ai/api/v1/chat/conversations" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"conversations": [
{
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
}
],
"total": 1,
"limit": 50,
"offset": 0
}Ver una conversación
/api/v1/chat/conversations/{id}La conversación y todos sus mensajes, del más viejo al más nuevo. Las notas internas vienen con isNote: true.
Scope chat:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id del registro. |
curl -X GET "https://zerosoft.ai/api/v1/chat/conversations/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"conversation": {
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
},
"messages": [
{
"id": "{message_id}",
"conversationId": "{conversation_id}",
"senderType": "user",
"userId": "{user_id}",
"body": "Hi Ana, the order ships tomorrow.",
"isNote": false,
"attachments": [],
"createdAt": "2026-11-01T18:02:00.000Z"
}
]
}Responder
/api/v1/chat/conversations/{id}/messagesManda un mensaje al visitante (o una nota interna con note: true). Como una respuesta desde el inbox, cuenta como primera respuesta para el SLA y reabre la conversación si estaba resuelta. Dispara chat.message.created.
Scope chat:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
body | string | Sí | Texto del mensaje (hasta 5000 caracteres). |
note | boolean | No | true para dejar una nota interna que el visitante no ve. |
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/messages" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"body": "Hi Ana, the order ships tomorrow."
}'Request
{
"body": "Hi Ana, the order ships tomorrow."
}Respuesta · 201
{
"id": "{message_id}",
"conversationId": "{conversation_id}",
"senderType": "user",
"userId": "{user_id}",
"body": "Hi Ana, the order ships tomorrow.",
"isNote": false,
"attachments": [],
"createdAt": "2026-11-01T18:02:00.000Z"
}Asignar
/api/v1/chat/conversations/{id}/assignAsigna la conversación a un agente de su widget, o la deja sin asignar con null. Dispara chat.conversation.assigned. Errores: 400 invalid_assignee.
Scope chat:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
assignedTo | string | Sí | Id de usuario del agente, o null para dejarla sin asignar. |
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/assign" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"assignedTo": "{user_id}"
}'Request
{
"assignedTo": "{user_id}"
}Respuesta · 200
{
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
}Resolver
/api/v1/chat/conversations/{id}/resolveMarca la conversación como resuelta. Si el widget tiene atributos obligatorios vacíos, responde 400 missing_attributes. Dispara chat.conversation.resolved.
Scope chat:write
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/resolve" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "resolved",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": "2026-11-01T18:10:00.000Z",
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
}Reabrir
/api/v1/chat/conversations/{id}/reopenVuelve a abrir una conversación resuelta o pospuesta.
Scope chat:write
curl -X POST "https://zerosoft.ai/api/v1/chat/conversations/{id}/reopen" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
}Robots
Corré tus robots de navegador desde tu propia app, de a uno o sobre muchas entradas. Las corridas pasan por la misma cola que en la app (una a la vez por workspace) y cuentan para los minutos mensuales de robots. Para correr hace falta una key creada por un admin del workspace.
Listar robots
/api/v1/robotsDevuelve los robots del workspace con sus entradas, para saber qué mandar al correrlos.
Scope robots:run
curl -X GET "https://zerosoft.ai/api/v1/robots" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"robots": [
{
"id": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
"name": "Price check",
"description": "",
"enabled": true,
"inputs": [
{
"name": "url",
"label": "Product URL",
"kind": "text",
"default": "",
"required": true
}
],
"updatedAt": "2026-11-01T18:00:00.000Z"
}
]
}Correr un robot
/api/v1/robots/:id/runsPone una corrida en cola y responde 202 con la corrida; consultá GET /api/v1/robots/runs/:id hasta que status sea success o failed. Con "wait": true la respuesta espera el resultado (200) si no hay otra corrida delante. El robot tiene que tener las corridas automáticas activadas. Errores: 404 not_found, 400 missing_input o disabled, 409 busy, 429 rate_limited o quota_exceeded, 503 runner_unavailable.
Scope robots:run
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
inputs | object | No | Entradas del robot por nombre. Las entradas de tipo lista llevan un array de textos. |
wait | boolean | No | Esperar el resultado en la misma respuesta (hasta el timeout del robot). Por defecto false. |
curl -X POST "https://zerosoft.ai/api/v1/robots/:id/runs" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"inputs": {
"url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
}
}'Request
{
"inputs": {
"url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
}
}Respuesta · 202
{
"run": {
"id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
"status": "queued",
"trigger": "api",
"input": {
"url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
},
"output": {},
"error": null,
"warnings": 0,
"changed": null,
"batchId": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"startedAt": null,
"finishedAt": null,
"durationMs": null
}
}Ver una corrida
/api/v1/robots/runs/:idEstado, entradas y datos extraídos de una corrida. changed dice si los datos difieren de la corrida exitosa anterior con las mismas entradas (null si no había con qué comparar).
Scope robots:run
curl -X GET "https://zerosoft.ai/api/v1/robots/runs/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"run": {
"id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
"robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
"status": "success",
"trigger": "api",
"input": {
"url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html"
},
"output": {
"title": "A Light in the Attic",
"price": "£51.77"
},
"error": null,
"warnings": 0,
"changed": false,
"batchId": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"startedAt": "2026-11-01T18:00:01.000Z",
"finishedAt": "2026-11-01T18:00:06.000Z",
"durationMs": 5000
}
}Correr un robot sobre muchas entradas
/api/v1/robots/:id/bulkDeja en cola una corrida por cada elemento de inputs (hasta 1.000 por pedido) bajo un id de lote. Para llegar a 50.000, mandá partes con el mismo batchId, el offset de la primera fila de cada parte y total: ninguna corrida arranca hasta que lleguen todas las filas, y reenviar una parte no la duplica. Las corridas siguen el ajuste de corridas a la vez del workspace; cada entrada del pedido se valida antes de dejar algo en cola. Errores: 400 missing_input (con el índice del elemento), 409 busy, 429 rate_limited.
Scope robots:run
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
inputs | object[] | Sí | Un objeto de entradas por corrida, de 1 a 1.000 por pedido. |
curl -X POST "https://zerosoft.ai/api/v1/robots/:id/bulk" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"inputs": [
{
"url": "https://example.com/a"
},
{
"url": "https://example.com/b"
}
]
}'Request
{
"inputs": [
{
"url": "https://example.com/a"
},
{
"url": "https://example.com/b"
}
]
}Respuesta · 202
{
"batchId": "3e2d1c0b-9a8f-4e7d-8c6b-5a4f3e2d1c0b",
"total": 2,
"runs": [
{
"id": "1f2e3d4c-…",
"status": "queued",
"input": {
"url": "https://example.com/a"
}
},
{
"id": "5b6a7c8d-…",
"status": "queued",
"input": {
"url": "https://example.com/b"
}
}
]
}Ver un lote
/api/v1/robots/batches/:idConteos por estado, done cuando todas terminaron y una página de corridas en el orden en que las mandaste: ?limit= (hasta 1.000, el valor por defecto) y ?offset=. nextOffset es el offset de la página siguiente, o null en la última.
Scope robots:run
curl -X GET "https://zerosoft.ai/api/v1/robots/batches/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"batchId": "3e2d1c0b-9a8f-4e7d-8c6b-5a4f3e2d1c0b",
"robotId": "c1f2a9d4-7b1e-4c2a-9f0e-1a2b3c4d5e6f",
"total": 2,
"counts": {
"queued": 0,
"running": 1,
"success": 1,
"failed": 0
},
"done": false,
"nextOffset": null,
"runs": [
{
"id": "1f2e3d4c-…",
"status": "success",
"input": {
"url": "https://example.com/a"
},
"output": {
"title": "A"
},
"error": null
},
{
"id": "5b6a7c8d-…",
"status": "running",
"input": {
"url": "https://example.com/b"
},
"output": {},
"error": null
}
]
}Lines (WhatsApp)
Leé chats y grupos de WhatsApp, mandá mensajes y creá tickets desde tus sistemas. Los mensajes salen del número al que pertenece el chat.
Listar chats y grupos
/api/v1/groups/chatsChats y grupos abiertos, los más recientes primero, con etiquetas, asignado y si esperan respuesta.
Scope groups:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
filter | string | No | all, unread, unanswered, flagged, mine, unassigned o closed |
q | string | No | Query de búsqueda. |
kind | string | No | group o dm |
curl -X GET "https://zerosoft.ai/api/v1/groups/chats" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "gc_1",
"kind": "group",
"name": "Acme · Support",
"memberCount": 12,
"assignedTo": null,
"labels": [
{
"id": "gl_1",
"name": "Enterprise",
"color": "blue"
}
],
"unread": 2,
"lastMessageAt": "2026-11-01T18:00:00.000Z",
"awaitingSince": "2026-11-01T18:00:00.000Z",
"flagged": false
}
],
"total": 1
}Listar mensajes
/api/v1/groups/chats/:id/messagesMensajes y notas internas de un chat, del más viejo al más nuevo.
Scope groups:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
after | string | No | Solo mensajes posteriores a esta fecha ISO |
curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id/messages" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "gm_1",
"direction": "in",
"senderName": "Ana",
"senderPhone": "5491155550000",
"body": "The October invoice did not arrive",
"status": "received",
"createdAt": "2026-11-01T18:00:00.000Z"
}
]
}Mandar un mensaje
/api/v1/groups/chats/:id/messagesManda un WhatsApp al chat o grupo, o guarda una nota interna con note: true.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
body | string | Sí | Texto del mensaje (hasta 4096 caracteres) |
note | boolean | No | Guardar como nota interna en vez de mandar |
poll | object | No | Objeto con question, options (2 a 12) y multi, en lugar de body. Solo WAHA y Evolution |
media | object | No | Objeto con url (https pública), mimetype y filename |
curl -X POST "https://zerosoft.ai/api/v1/groups/chats/:id/messages" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"body": "Hi Ana, resending it now."
}'Request
{
"body": "Hi Ana, resending it now."
}Respuesta · 201
{
"data": {
"id": "gm_2",
"direction": "out",
"body": "Hi Ana, resending it now.",
"status": "sent",
"createdAt": "2026-11-01T18:01:00.000Z"
}
}Listar tickets
/api/v1/groups/ticketsTickets creados desde mensajes de WhatsApp, con su estado de SLA.
Scope groups:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
status | string | No | active (por defecto), all, open, in_progress, resolved o closed |
curl -X GET "https://zerosoft.ai/api/v1/groups/tickets" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "gt_1",
"number": 12,
"title": "Invoice did not arrive",
"status": "open",
"priority": "high",
"source": "reaction",
"dueAt": "2026-11-02T18:00:00.000Z",
"breached": false
}
]
}Crear un ticket
/api/v1/groups/ticketsCrea un ticket en un chat. Con messageId, un mensaje tiene a lo sumo un ticket: repetir devuelve el existente.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
chatId | string | Sí | Id del chat o grupo |
title | string | No | Título del ticket (por defecto, la primera línea del mensaje) |
priority | string | No | low, medium, high o urgent |
curl -X POST "https://zerosoft.ai/api/v1/groups/tickets" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"chatId": "gc_1",
"title": "Invoice did not arrive",
"priority": "high"
}'Request
{
"chatId": "gc_1",
"title": "Invoice did not arrive",
"priority": "high"
}Respuesta · 201
{
"data": {
"id": "gt_1",
"number": 12,
"title": "Invoice did not arrive",
"status": "open",
"priority": "high",
"source": "api"
}
}Ver un chat
/api/v1/groups/chats/:idUn chat o grupo con sus etiquetas, asignado y miembros.
Scope groups:read
curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "gc_1",
"kind": "group",
"name": "Acme · Support",
"memberCount": 12,
"status": "open",
"labels": [],
"members": [
{
"phone": "5491155550000",
"name": "Ana",
"role": "admin"
}
]
}
}Actualizar un chat
/api/v1/groups/chats/:idAsignar, cerrar o reabrir, reemplazar etiquetas, renombrar (también en WhatsApp si es grupo) o cargar propiedades. Los cambios quedan en la auditoría.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
assignedTo | string | No | Id de una persona del workspace, o null para desasignar |
status | open | closed | No | open o closed |
labelIds | string[] | No | Ids de etiquetas (reemplazan las actuales) |
name | string | No | Nombre |
curl -X PATCH "https://zerosoft.ai/api/v1/groups/chats/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"assignedTo": "u_1",
"labelIds": [
"gl_1"
]
}'Request
{
"assignedTo": "u_1",
"labelIds": [
"gl_1"
]
}Respuesta · 200
{
"data": {
"id": "gc_1",
"assignedTo": "u_1",
"status": "open",
"labels": [
{
"id": "gl_1",
"name": "Enterprise",
"color": "blue"
}
]
}
}Listar miembros de un grupo
/api/v1/groups/chats/:id/membersMiembros de un grupo con su rol (member, admin o superadmin).
Scope groups:read
curl -X GET "https://zerosoft.ai/api/v1/groups/chats/:id/members" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"phone": "5491155550000",
"name": "Ana",
"role": "admin"
}
]
}Sumar, quitar o promover miembros
/api/v1/groups/chats/:id/membersCambia miembros en WhatsApp (números WAHA o Evolution). Con action invite devuelve el link de invitación; revoke: true genera uno nuevo.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
action | add | remove | promote | demote | invite | Sí | Qué hacer con los teléfonos |
phones | string[] | No | Teléfonos en formato internacional |
curl -X POST "https://zerosoft.ai/api/v1/groups/chats/:id/members" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"action": "add",
"phones": [
"+5491155550001"
]
}'Request
{
"action": "add",
"phones": [
"+5491155550001"
]
}Respuesta · 200
{
"data": {
"results": [
{
"phone": "5491155550001",
"ok": true
}
],
"members": []
}
}Crear grupos
/api/v1/groups/groupsCrea un grupo de WhatsApp, o hasta 50 con groups: [...]. Los teléfonos que WhatsApp no dejó agregar vuelven en notAdded.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
numberId | string | Sí | Número que crea el grupo (WAHA o Evolution) |
name | string | Sí | Nombre |
phones | string[] | No | Teléfonos en formato internacional |
curl -X POST "https://zerosoft.ai/api/v1/groups/groups" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"numberId": "gn_1",
"name": "Acme · Onboarding",
"phones": [
"+5491155550001"
]
}'Request
{
"numberId": "gn_1",
"name": "Acme · Onboarding",
"phones": [
"+5491155550001"
]
}Respuesta · 201
{
"data": [
{
"name": "Acme · Onboarding",
"ok": true,
"chatId": "gc_2",
"notAdded": []
}
]
}Listar números
/api/v1/groups/numbersNúmeros de WhatsApp conectados con proveedor, estado y capacidades. Las credenciales nunca se devuelven.
Scope groups:read
curl -X GET "https://zerosoft.ai/api/v1/groups/numbers" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "gn_1",
"name": "Support line",
"provider": "waha",
"phone": "5491155550000",
"status": "connected"
}
]
}Listar etiquetas
/api/v1/groups/labelsEtiquetas del workspace con cuántos chats tiene cada una.
Scope groups:read
curl -X GET "https://zerosoft.ai/api/v1/groups/labels" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "gl_1",
"name": "Enterprise",
"color": "blue",
"count": 4
}
]
}Crear una etiqueta
/api/v1/groups/labelsColores: gray, red, orange, yellow, green, teal, blue, purple o pink.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre |
curl -X POST "https://zerosoft.ai/api/v1/groups/labels" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Enterprise",
"color": "blue"
}'Request
{
"name": "Enterprise",
"color": "blue"
}Respuesta · 201
{
"data": {
"id": "gl_1",
"name": "Enterprise",
"color": "blue"
}
}Ver un ticket
/api/v1/groups/tickets/:idEl ticket con sus tickets vinculados en Freshdesk o Zoho Desk, si hay.
Scope groups:read
curl -X GET "https://zerosoft.ai/api/v1/groups/tickets/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "gt_1",
"number": 12,
"title": "Invoice did not arrive",
"status": "open",
"links": [
{
"kind": "freshdesk",
"remoteId": "1042",
"remoteUrl": "https://acme.freshdesk.com/a/tickets/1042"
}
]
}
}Actualizar un ticket
/api/v1/groups/tickets/:idEstado, prioridad, asignado o título. El estado nuevo se manda a los tickets vinculados de Freshdesk o Zoho Desk.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
status | string | No | active (por defecto), all, open, in_progress, resolved o closed |
priority | string | No | low, medium, high o urgent |
assigneeId | string | No | Id de una persona del workspace, o null para desasignar |
curl -X PATCH "https://zerosoft.ai/api/v1/groups/tickets/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"status": "resolved"
}'Request
{
"status": "resolved"
}Respuesta · 200
{
"data": {
"id": "gt_1",
"number": 12,
"status": "resolved"
}
}Mandar un envío masivo
/api/v1/groups/broadcastsManda un mensaje o una encuesta a muchos chats y grupos desde un número, con el ritmo que elijas (perMinute). Con scheduledAt sale más tarde.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
chatIds | string[] | Sí | Ids de chats y grupos |
body | string | No | Texto del mensaje (hasta 4096 caracteres) |
poll | object | No | Objeto con question, options (2 a 12) y multi, en lugar de body. Solo WAHA y Evolution |
scheduledAt | string | No | Fecha ISO para mandar más tarde |
curl -X POST "https://zerosoft.ai/api/v1/groups/broadcasts" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"chatIds": [
"gc_1",
"gc_2"
],
"body": "Hi {{first_name}}, the new release is live.",
"perMinute": 20
}'Request
{
"chatIds": [
"gc_1",
"gc_2"
],
"body": "Hi {{first_name}}, the new release is live.",
"perMinute": 20
}Respuesta · 201
{
"data": {
"id": "gb_1",
"status": "scheduled",
"total": 2
}
}Crear un mensaje recurrente
/api/v1/groups/recurringRepite un mensaje o una encuesta todos los días, cada semana, cada mes o con una expresión cron. GET en la misma ruta los lista con su próxima corrida.
Scope groups:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
chatIds | string[] | Sí | Ids de chats y grupos |
rule | object | Sí | Objeto con freq (daily, weekly, monthly o cron), time (HH:MM), days (0 a 6), dayOfMonth o cron |
timezone | string | No | Zona horaria IANA (por defecto UTC) |
endsAt | string | No | Fecha ISO de fin, opcional |
curl -X POST "https://zerosoft.ai/api/v1/groups/recurring" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"chatIds": [
"gc_1"
],
"body": "Weekly check-in: anything blocking you?",
"rule": {
"freq": "weekly",
"days": [
1
],
"time": "09:00"
},
"timezone": "America/Argentina/Buenos_Aires"
}'Request
{
"chatIds": [
"gc_1"
],
"body": "Weekly check-in: anything blocking you?",
"rule": {
"freq": "weekly",
"days": [
1
],
"time": "09:00"
},
"timezone": "America/Argentina/Buenos_Aires"
}Respuesta · 201
{
"data": {
"id": "gr_1",
"status": "active",
"nextRunAt": "2026-11-02T12:00:00.000Z"
}
}Servidor MCP
/api/v1/groups/mcpModel Context Protocol por streamable HTTP (JSON-RPC). Métodos: initialize, tools/list, tools/call. Herramientas: list_chats, get_messages, send_message, send_poll, update_chat, list_labels, create_ticket, list_tickets, update_ticket. Las que escriben piden groups:write.
Scope groups:read
curl -X POST "https://zerosoft.ai/api/v1/groups/mcp" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_chats",
"arguments": {
"filter": "unanswered"
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_chats",
"arguments": {
"filter": "unanswered"
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"total\":1,\"chats\":[...]}"
}
],
"isError": false
}
}Voice
Dictado y transcripciones de reuniones. La app de escritorio usa estos endpoints con una key con voice:read y voice:write. El audio se transcribe y se descarta.
Dictar
/api/v1/voice/dictateSube un audio en multipart. Devuelve la transcripción limpia con el diccionario y el estilo de la persona, y la guarda en su historial de dictados.
Scope voice:write
curl -X POST "https://zerosoft.ai/api/v1/voice/dictate" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"audio": "(multipart file, webm/ogg/wav/m4a/mp3, up to 4 MB)",
"context": "email",
"sourceApp": "Mail",
"durationMs": 5200
}'Request
{
"audio": "(multipart file, webm/ogg/wav/m4a/mp3, up to 4 MB)",
"context": "email",
"sourceApp": "Mail",
"durationMs": 5200
}Respuesta · 201
{
"data": {
"id": "vs_1",
"text": "The launch is on Tuesday.",
"raw": "um the launch is on monday, no, I mean tuesday",
"ai": true
}
}Listar sesiones
/api/v1/voice/sessionsDictados y reuniones de quien creó la key, de la más nueva a la más vieja.
Scope voice:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
kind | string | No | meeting o dictation. |
q | string | No | Query de búsqueda. |
curl -X GET "https://zerosoft.ai/api/v1/voice/sessions" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "vs_2",
"kind": "meeting",
"title": "Acme pricing call",
"status": "done",
"durationMs": 1820000,
"startedAt": "2026-11-02T15:00:00.000Z"
}
]
}Crear una reunión
/api/v1/voice/sessionsEmpieza una reunión a la que subir trozos de audio.
Scope voice:write
curl -X POST "https://zerosoft.ai/api/v1/voice/sessions" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Acme pricing call"
}'Request
{
"title": "Acme pricing call"
}Respuesta · 201
{
"data": {
"id": "vs_2",
"title": "Acme pricing call",
"status": "recording",
"startedAt": "2026-11-02T15:00:00.000Z"
}
}Subir un trozo de audio
/api/v1/voice/sessions/:id/chunksTranscribe un trozo de la reunión. source es me (micrófono), them (audio del sistema) o mixed. Idempotente por source y seq.
Scope voice:write
curl -X POST "https://zerosoft.ai/api/v1/voice/sessions/:id/chunks" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"audio": "(multipart file, up to 4 MB)",
"source": "them",
"seq": 200,
"offsetMs": 20000,
"durationMs": 20000
}'Request
{
"audio": "(multipart file, up to 4 MB)",
"source": "them",
"seq": 200,
"offsetMs": 20000,
"durationMs": 20000
}Respuesta · 201
{
"data": {
"duplicate": false,
"segments": [
{
"id": "sg_1",
"source": "them",
"speaker": "0",
"startMs": 20400,
"endMs": 24100,
"text": "Twenty dollars works for us."
}
]
}
}Ver una sesión
/api/v1/voice/sessions/:idLa sesión con su transcripción, notas y nota con IA.
Scope voice:read
curl -X GET "https://zerosoft.ai/api/v1/voice/sessions/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "vs_2",
"title": "Acme pricing call",
"segments": [],
"myNotes": "",
"enhanced": null
}
}Actualizar una sesión
/api/v1/voice/sessions/:idCambiarle el título, o poner status en done al terminar de grabar.
Scope voice:write
curl -X PATCH "https://zerosoft.ai/api/v1/voice/sessions/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"status": "done"
}'Request
{
"status": "done"
}Respuesta · 200
{
"data": {
"id": "vs_2",
"title": "Acme pricing call",
"status": "done",
"durationMs": 1820000
}
}Diccionario y ajustes
/api/v1/voice/dictionaryPalabras, reemplazos, snippets y ajustes de dictado de la persona, para sincronizar la app de escritorio.
Scope voice:read
curl -X GET "https://zerosoft.ai/api/v1/voice/dictionary" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"entries": [
{
"id": "vd_1",
"kind": "replace",
"phrase": "zero soft",
"replacement": "zerosoft"
}
],
"settings": {
"language": "auto",
"shortcut": "Alt+Space"
}
}
}Track
Issues, comentarios, equipos, cycles, status, labels y personas de Track. Usá una key con track:read o track:write. Los issues creados por API van a triage si el equipo lo tiene activo, y cada cambio deja actividad, avisos, webhooks y una entrada de audit como la app. Los equipos antes se llamaban proyectos: /api/v1/track/projects y projectId siguen funcionando.
Listar issues
/api/v1/track/issuesIssues que ve la key, los editados más recientes primero, con filtros.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
teamId | string | No | Id o clave del equipo (WEB). projectId también funciona. |
statusCategory | backlog | todo | in_progress | done | cancelled | No | Categoría del status. |
assigneeId | string | No | Id de la persona asignada. |
priority | urgent | high | medium | low | No | Prioridad. |
q | string | No | Query de búsqueda. |
updatedSince | string | No | Solo issues editados desde esta fecha ISO. |
page | integer | No | Número de página. |
pageSize | integer | No | Items por página (máx 100). |
curl -X GET "https://zerosoft.ai/api/v1/track/issues" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"url": "https://zerosoft.ai/app/track/issues/{issue_id}",
"projectId": "{team_id}",
"teamId": "{team_id}",
"planId": null,
"status": {
"id": "{status_id}",
"name": "In Progress",
"category": "in_progress",
"color": "#000000"
},
"priority": "high",
"assignee": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"creatorId": "{user_id}",
"cycle": {
"id": "{cycle_id}",
"name": "Cycle 4"
},
"milestoneId": null,
"parentId": null,
"estimate": 3,
"labels": [
{
"id": "{label_id}",
"name": "bug",
"color": "#d14343"
}
],
"startDate": null,
"dueDate": "2026-11-04",
"triage": false,
"source": "api",
"createdAt": "2026-10-25T14:02:11.000Z",
"updatedAt": "2026-10-25T15:10:00.000Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1,
"hasMore": false
}Crear un issue
/api/v1/track/issuesteamId acepta el id o la clave (WEB); projectId es el nombre anterior. status acepta el nombre del status o una categoría. Los links de Sentry, Zendesk, Intercom o Figma quedan vinculados al issue.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
teamId | string | Sí | Id o clave del equipo (WEB). projectId también funciona. |
title | string | Sí | Título del issue. |
description | string | No | Descripción en markdown. |
status | string | No | Nombre del status ("In Progress") o categoría (in_progress). |
priority | urgent | high | medium | low | No | Prioridad. |
assigneeEmail | string | No | Email de un miembro del equipo. |
labels | string[] | No | Nombres de labels; los que no existen se crean. |
dueDate | string | No | Vencimiento, YYYY-MM-DD. |
links | string[] | No | URLs de Sentry, Zendesk, Intercom o Figma para vincular. |
curl -X POST "https://zerosoft.ai/api/v1/track/issues" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"teamId": "WEB",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"priority": "high",
"labels": [
"bug"
],
"links": [
"https://acme.zendesk.com/agent/tickets/4812"
]
}'Request
{
"teamId": "WEB",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"priority": "high",
"labels": [
"bug"
],
"links": [
"https://acme.zendesk.com/agent/tickets/4812"
]
}Respuesta · 201
{
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"url": "https://zerosoft.ai/app/track/issues/{issue_id}",
"projectId": "{team_id}",
"teamId": "{team_id}",
"planId": null,
"status": {
"id": "{status_id}",
"name": "In Progress",
"category": "in_progress",
"color": "#000000"
},
"priority": "high",
"assignee": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"creatorId": "{user_id}",
"cycle": {
"id": "{cycle_id}",
"name": "Cycle 4"
},
"milestoneId": null,
"parentId": null,
"estimate": 3,
"labels": [
{
"id": "{label_id}",
"name": "bug",
"color": "#d14343"
}
],
"startDate": null,
"dueDate": "2026-11-04",
"triage": false,
"source": "api",
"createdAt": "2026-10-25T14:02:11.000Z",
"updatedAt": "2026-10-25T15:10:00.000Z"
}Ver un issue
/api/v1/track/issues/{id}Por id o identificador (WEB-12).
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o identificador del issue (WEB-12). |
curl -X GET "https://zerosoft.ai/api/v1/track/issues/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"url": "https://zerosoft.ai/app/track/issues/{issue_id}",
"projectId": "{team_id}",
"teamId": "{team_id}",
"planId": null,
"status": {
"id": "{status_id}",
"name": "In Progress",
"category": "in_progress",
"color": "#000000"
},
"priority": "high",
"assignee": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"creatorId": "{user_id}",
"cycle": {
"id": "{cycle_id}",
"name": "Cycle 4"
},
"milestoneId": null,
"parentId": null,
"estimate": 3,
"labels": [
{
"id": "{label_id}",
"name": "bug",
"color": "#d14343"
}
],
"startDate": null,
"dueDate": "2026-11-04",
"triage": false,
"source": "api",
"createdAt": "2026-10-25T14:02:11.000Z",
"updatedAt": "2026-10-25T15:10:00.000Z"
}Editar un issue
/api/v1/track/issues/{id}Mandá solo lo que cambia. Cambiar status o asignado acepta un issue que está en triage.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o identificador del issue (WEB-12). |
status | string | No | Nombre del status ("In Progress") o categoría (in_progress). |
assigneeEmail | string | No | Email de un miembro del equipo. |
priority | urgent | high | medium | low | No | Prioridad. |
curl -X PATCH "https://zerosoft.ai/api/v1/track/issues/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"status": "Done"
}'Request
{
"status": "Done"
}Respuesta · 200
{
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"description": "Steps: open /pricing, press Buy.",
"url": "https://zerosoft.ai/app/track/issues/{issue_id}",
"projectId": "{team_id}",
"teamId": "{team_id}",
"planId": null,
"status": {
"id": "{status_id}",
"name": "Done",
"category": "done",
"color": "#000000"
},
"priority": "high",
"assignee": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"creatorId": "{user_id}",
"cycle": {
"id": "{cycle_id}",
"name": "Cycle 4"
},
"milestoneId": null,
"parentId": null,
"estimate": 3,
"labels": [
{
"id": "{label_id}",
"name": "bug",
"color": "#d14343"
}
],
"startDate": null,
"dueDate": "2026-11-04",
"triage": false,
"source": "api",
"createdAt": "2026-10-25T14:02:11.000Z",
"updatedAt": "2026-10-25T15:10:00.000Z"
}Borrar un issue
/api/v1/track/issues/{id}Borra el issue y sus sub-issues.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o identificador del issue (WEB-12). |
curl -X DELETE "https://zerosoft.ai/api/v1/track/issues/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{issue_id}",
"deleted": true
}Listar comentarios
/api/v1/track/issues/{id}/commentsComentarios de un issue, los más viejos primero.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o identificador del issue (WEB-12). |
curl -X GET "https://zerosoft.ai/api/v1/track/issues/{id}/comments" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{comment_id}",
"issueId": "{issue_id}",
"body": "Reproduced on Safari 18.",
"author": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"createdAt": "2026-10-25T15:00:00.000Z",
"updatedAt": "2026-10-25T15:00:00.000Z"
}
]
}Comentar
/api/v1/track/issues/{id}/commentsComenta como el dueño de la key en markdown y avisa a suscriptos y menciones.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o identificador del issue (WEB-12). |
body | string | Sí | Comentario en markdown. |
curl -X POST "https://zerosoft.ai/api/v1/track/issues/{id}/comments" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"body": "Deployed the fix to staging."
}'Request
{
"body": "Deployed the fix to staging."
}Respuesta · 201
{
"id": "{comment_id}",
"issueId": "{issue_id}",
"body": "Deployed the fix to staging.",
"author": {
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com"
},
"createdAt": "2026-10-25T16:00:00.000Z",
"updatedAt": "2026-10-25T16:00:00.000Z"
}Listar equipos
/api/v1/track/teamsEquipos activos que ve la key. includeArchived=true suma los archivados.
Scope track:read
curl -X GET "https://zerosoft.ai/api/v1/track/teams" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{team_id}",
"name": "Web",
"key": "WEB",
"description": "",
"icon": null,
"color": "#000000",
"status": "active",
"visibility": "workspace",
"triageEnabled": true,
"url": "https://zerosoft.ai/app/track/team/WEB",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-10-20T10:00:00.000Z"
}
]
}Crear un equipo
/api/v1/track/teamsSolo admins. Crea los status por defecto. key es el prefijo de los identificadores.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre |
key | string | No | Prefijo de los identificadores, letras y números (WEB). |
description | string | No | Descripción |
curl -X POST "https://zerosoft.ai/api/v1/track/teams" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Web",
"key": "WEB"
}'Request
{
"name": "Web",
"key": "WEB"
}Respuesta · 201
{
"id": "{team_id}",
"name": "Web",
"key": "WEB",
"description": "",
"icon": null,
"color": "#000000",
"status": "active",
"visibility": "workspace",
"triageEnabled": true,
"url": "https://zerosoft.ai/app/track/team/WEB",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-10-20T10:00:00.000Z"
}Ver un equipo
/api/v1/track/teams/{id}Por id o clave, con sus status.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o clave del equipo (WEB). projectId también funciona. |
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"id": "{team_id}",
"name": "Web",
"key": "WEB",
"description": "",
"icon": null,
"color": "#000000",
"status": "active",
"visibility": "workspace",
"triageEnabled": true,
"url": "https://zerosoft.ai/app/track/team/WEB",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-10-20T10:00:00.000Z",
"statuses": [
{
"id": "{status_id}",
"projectId": "{project_id}",
"name": "Todo",
"category": "todo",
"color": "#000000",
"position": 1
}
]
}Editar un equipo
/api/v1/track/teams/{id}Nombre, descripción, color e icono. Archivar y triage piden una key de admin.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o clave del equipo (WEB). projectId también funciona. |
status | active | archived | No | active o archived. |
curl -X PATCH "https://zerosoft.ai/api/v1/track/teams/{id}" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"description": "Marketing site and checkout"
}'Request
{
"description": "Marketing site and checkout"
}Respuesta · 200
{
"id": "{team_id}",
"name": "Web",
"key": "WEB",
"description": "",
"icon": null,
"color": "#000000",
"status": "active",
"visibility": "workspace",
"triageEnabled": true,
"url": "https://zerosoft.ai/app/track/team/WEB",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-10-20T10:00:00.000Z"
}Listar cycles
/api/v1/track/teams/{id}/cyclesCycles de un equipo.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o clave del equipo (WEB). projectId también funciona. |
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}/cycles" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{cycle_id}",
"projectId": "{project_id}",
"name": "Cycle 4",
"startAt": "2026-10-20",
"endAt": "2026-11-02",
"completedAt": null
}
]
}Crear un cycle
/api/v1/track/teams/{id}/cyclesFechas en YYYY-MM-DD.
Scope track:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre |
startAt | string | Sí | Fecha, YYYY-MM-DD. |
endAt | string | Sí | Fecha, YYYY-MM-DD. |
curl -X POST "https://zerosoft.ai/api/v1/track/teams/{id}/cycles" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Cycle 5",
"startAt": "2026-11-03",
"endAt": "2026-11-16"
}'Request
{
"name": "Cycle 5",
"startAt": "2026-11-03",
"endAt": "2026-11-16"
}Respuesta · 201
{
"id": "{cycle_id}",
"projectId": "{project_id}",
"name": "Cycle 5",
"startAt": "2026-11-03",
"endAt": "2026-11-16",
"completedAt": null
}Listar status
/api/v1/track/teams/{id}/statusesStatus del workflow de un equipo en orden, con su categoría.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | Id o clave del equipo (WEB). projectId también funciona. |
curl -X GET "https://zerosoft.ai/api/v1/track/teams/{id}/statuses" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{status_id}",
"projectId": "{project_id}",
"name": "In Progress",
"category": "in_progress",
"color": "#000000",
"position": 2
}
]
}Listar labels
/api/v1/track/labelsLabels del workspace. POST con name y teamId crea uno.
Scope track:read
curl -X GET "https://zerosoft.ai/api/v1/track/labels" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{label_id}",
"name": "bug",
"color": "#d14343",
"workspaceId": "{workspace_id}"
}
]
}Listar personas
/api/v1/track/usersPersonas que se pueden asignar, de un equipo o de todos.
Scope track:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
teamId | string | No | Id o clave del equipo (WEB). projectId también funciona. |
curl -X GET "https://zerosoft.ai/api/v1/track/users" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "{user_id}",
"name": "Ana",
"email": "ana@example.com",
"role": "member"
}
]
}Servidor MCP de Track
Model Context Protocol por Streamable HTTP en /api/mcp/track (solo lectura en /api/mcp/track/readonly). Autenticación con una API key como Bearer. Herramientas: search_issues, get_issue, create_issue, update_issue, add_comment, list_teams, get_team, list_cycles, list_labels, list_users.
Llamar a una herramienta
/api/mcp/trackJSON-RPC 2.0: initialize, tools/list y tools/call. Las herramientas que escriben piden track:write.
Scope track:read
curl -X POST "https://zerosoft.ai/api/mcp/track" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_issues",
"arguments": {
"query": "checkout",
"statusCategory": "in_progress"
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_issues",
"arguments": {
"query": "checkout",
"statusCategory": "in_progress"
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{ \"total\": 1, \"issues\": [ … ] }"
}
],
"isError": false
}
}Docs
Leé y escribí páginas, bloques, bases, filas y comentarios de Docs. El contenido entra y sale en Markdown (o en bloques de Docs). Una key actúa como la persona que la creó: solo ve y edita las páginas que esa persona puede abrir. Las bases sincronizadas son de solo lectura.
Listar páginas
/api/v1/docs/pagesPáginas que la key puede leer, más nuevas primero. Con q busca en títulos y contenido.
Scope docs:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
parent | string | No | Solo páginas dentro de este id (root para las de arriba). |
limit | number | No | Cuántos devolver (1 a 100, 50 por defecto). |
offset | number | No | Cuántos saltear, para paginar. |
curl -X GET "https://zerosoft.ai/api/v1/docs/pages" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "pg_1",
"title": "Launch plan",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false
}
],
"hasMore": false
}Crear una página
/api/v1/docs/pagesCrea una página desde Markdown o bloques, dentro de otra (parentId) o desde una plantilla (id de plantilla del workspace o builtin:<key>). Las {{variables}} de la plantilla se completan con vars.
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | No | Título de la página. |
markdown | string | No | Contenido en Markdown (títulos, listas, to-dos, citas, código, tablas). |
parentId | string | No | Crearla como subpágina de esta página. |
templateId | string | No | Id de plantilla del workspace o builtin:<key>. |
curl -X POST "https://zerosoft.ai/api/v1/docs/pages" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Launch plan",
"parentId": "pg_root",
"markdown": "## Goals\n\n- [ ] Ship the beta"
}'Request
{
"title": "Launch plan",
"parentId": "pg_root",
"markdown": "## Goals\n\n- [ ] Ship the beta"
}Respuesta · 201
{
"data": {
"id": "pg_1",
"title": "Launch plan",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false,
"access": "owner",
"markdown": "## Goals\n\n- [ ] Ship the beta",
"databases": []
}
}Leer una página
/api/v1/docs/pages/:idLa página con su contenido en Markdown y sus bases. Con format=blocks trae también los bloques.
Scope docs:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
format | string | No | blocks para traer también los bloques. |
curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "pg_1",
"title": "Launch plan",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false,
"access": "edit",
"markdown": "## Goals\n\n- [ ] Ship the beta",
"databases": [
{
"blockId": "b_1",
"title": "Tasks",
"rows": 12,
"synced": false
}
]
}
}Actualizar una página
/api/v1/docs/pages/:idCambia el título o el ícono, reemplaza el contenido (las bases de la página se conservan) o la manda a la papelera y la saca (archived).
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | No | Título de la página. |
markdown | string | No | Reemplaza todo el contenido (las bases se conservan). |
archived | boolean | No | true la manda a la papelera, false la restaura. |
curl -X PATCH "https://zerosoft.ai/api/v1/docs/pages/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Launch plan (Q4)"
}'Request
{
"title": "Launch plan (Q4)"
}Respuesta · 200
{
"data": {
"id": "pg_1",
"title": "Launch plan (Q4)",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false,
"access": "owner",
"markdown": "",
"databases": []
}
}Mandar una página a la papelera
/api/v1/docs/pages/:idManda la página y sus subpáginas a la papelera. Se restaura con PATCH archived: false.
Scope docs:write
curl -X DELETE "https://zerosoft.ai/api/v1/docs/pages/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Listar bloques
/api/v1/docs/pages/:id/blocksLos bloques de una página en formato Docs (tipo, contenido en HTML-lite, anidado con indent).
Scope docs:read
curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id/blocks" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "b_1",
"type": "heading",
"level": 2,
"content": "Goals"
},
{
"id": "b_2",
"type": "todo",
"content": "Ship the beta",
"checked": false
}
]
}Agregar bloques
/api/v1/docs/pages/:id/blocksAgrega Markdown o bloques al final de la página, o debajo del bloque de after. Quien tiene la página abierta lo ve fusionado en su editor.
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
markdown | string | No | Contenido en Markdown (títulos, listas, to-dos, citas, código, tablas). |
blocks | object[] | No | Bloques en formato Docs (en vez de Markdown). |
after | string | No | Insertar debajo de este id de bloque. |
curl -X POST "https://zerosoft.ai/api/v1/docs/pages/:id/blocks" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"markdown": "- [ ] Write the release notes"
}'Request
{
"markdown": "- [ ] Write the release notes"
}Respuesta · 201
{
"data": {
"id": "pg_1",
"title": "Launch plan",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false,
"access": "owner",
"markdown": "- [ ] Write the release notes",
"databases": []
}
}Listar comentarios
/api/v1/docs/pages/:id/commentsComentarios e hilos de una página.
Scope docs:read
curl -X GET "https://zerosoft.ai/api/v1/docs/pages/:id/comments" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "cm_1",
"pageId": "pg_1",
"blockId": null,
"parentId": null,
"text": "Can we ship this in May?",
"resolved": false,
"author": {
"id": "u_1",
"name": "Ada",
"email": "ada@example.com"
},
"createdAt": "2026-11-02T10:00:00.000Z"
}
]
}Comentar
/api/v1/docs/pages/:id/commentsComenta la página o un bloque, o responde un hilo, como la persona que creó la key.
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
text | string | Sí | Texto del comentario. |
blockId | string | No | Comentar este bloque. |
parentId | string | No | Responder en el hilo de este comentario. |
curl -X POST "https://zerosoft.ai/api/v1/docs/pages/:id/comments" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"text": "Done, the beta is live."
}'Request
{
"text": "Done, the beta is live."
}Respuesta · 201
{
"data": {
"id": "cm_2",
"pageId": "pg_1",
"blockId": null,
"parentId": null,
"text": "Done, the beta is live.",
"resolved": false,
"author": {
"id": "u_1",
"name": "Ada",
"email": "ada@example.com"
},
"createdAt": "2026-11-02T11:00:00.000Z"
}
}Listar bases
/api/v1/docs/databasesBases de las páginas que la key puede leer, con sus propiedades y opciones.
Scope docs:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
curl -X GET "https://zerosoft.ai/api/v1/docs/databases" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"pageId": "pg_1",
"blockId": "b_1",
"title": "Tasks",
"page": {
"id": "pg_1",
"title": "Launch plan"
},
"synced": null,
"properties": [
{
"id": "title",
"name": "Name",
"type": "title"
},
{
"id": "status",
"name": "Status",
"type": "status",
"options": [
"Not started",
"In progress",
"Done"
]
}
],
"rowCount": 12
}
]
}Leer una base
/api/v1/docs/databases/:pageId/:blockIdPropiedades de una base y, si está sincronizada, de dónde viene.
Scope docs:read
curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"pageId": "pg_1",
"blockId": "b_1",
"title": "Issues",
"page": {
"id": "pg_1",
"title": "Engineering"
},
"synced": {
"provider": "github",
"label": "acme/web · Issues",
"syncedAt": "2026-11-02T10:15:00.000Z"
},
"properties": [
{
"id": "title",
"name": "Title",
"type": "title"
}
],
"rowCount": 40
}
}Consultar filas
/api/v1/docs/databases/:pageId/:blockId/rowsFilas de una base con sus propiedades como texto (properties) y valores crudos (values). filter[Propiedad]=texto deja las filas cuyo valor lo contiene.
Scope docs:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
filter[Property] | string | No | Deja las filas cuya Propiedad contiene el texto. |
limit | number | No | Cuántos devolver (1 a 100, 50 por defecto). |
offset | number | No | Cuántos saltear, para paginar. |
curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "r_1",
"title": "Website refresh",
"url": "/app/docs/pg_1?row=r_1",
"properties": {
"Status": "In progress",
"Owner": "Ada"
},
"values": {
"Status": "opt_2",
"Owner": [
"u_1"
]
},
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:00:00.000Z"
}
],
"total": 1,
"hasMore": false
}Agregar una fila
/api/v1/docs/databases/:pageId/:blockId/rowsAgrega una fila. properties va de nombre (o id) de propiedad a valor: las opciones de select se crean si faltan, las personas van por email y las fechas como AAAA-MM-DD. Las automatizaciones de la base corren como siempre.
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | No | Título de la fila. |
properties | object | No | Nombre o id de propiedad → valor. |
markdown | string | No | Contenido de la fila en Markdown. |
template | string | No | Plantilla de fila de la base (id o nombre). |
curl -X POST "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Website refresh",
"properties": {
"Status": "In progress",
"Owner": "ada@example.com",
"Tags": [
"web",
"q4"
]
}
}'Request
{
"title": "Website refresh",
"properties": {
"Status": "In progress",
"Owner": "ada@example.com",
"Tags": [
"web",
"q4"
]
}
}Respuesta · 201
{
"data": {
"id": "r_2",
"title": "Website refresh",
"url": "/app/docs/pg_1?row=r_2",
"properties": {
"Status": "In progress",
"Owner": "Ada",
"Tags": "web, q4"
},
"values": {},
"createdAt": "2026-11-02T12:00:00.000Z",
"updatedAt": "2026-11-02T12:00:00.000Z"
}
}Leer una fila
/api/v1/docs/databases/:pageId/:blockId/rows/:rowIdUna fila con sus propiedades y su contenido en Markdown.
Scope docs:read
curl -X GET "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "r_1",
"title": "Website refresh",
"url": "/app/docs/pg_1?row=r_1",
"properties": {
"Status": "In progress"
},
"values": {},
"markdown": "Brief and links.",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:00:00.000Z"
}
}Actualizar una fila
/api/v1/docs/databases/:pageId/:blockId/rows/:rowIdCambia propiedades, el título o el contenido de una fila.
Scope docs:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
properties | object | No | Nombre o id de propiedad → valor. |
title | string | No | Título de la fila. |
appendMarkdown | string | No | Markdown para agregar al final del contenido de la fila. |
curl -X PATCH "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"properties": {
"Status": "Done"
}
}'Request
{
"properties": {
"Status": "Done"
}
}Respuesta · 200
{
"data": {
"id": "r_1",
"title": "Website refresh",
"url": "/app/docs/pg_1?row=r_1",
"properties": {
"Status": "Done"
},
"values": {},
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T13:00:00.000Z"
}
}Borrar una fila
/api/v1/docs/databases/:pageId/:blockId/rows/:rowIdBorra la fila. Queda en el historial de la página.
Scope docs:write
curl -X DELETE "https://zerosoft.ai/api/v1/docs/databases/:pageId/:blockId/rows/:rowId" \
-H "Authorization: Bearer zs_live_9f3k..."Buscar
/api/v1/docs/searchPáginas y filas de bases por título y contenido, con un fragmento.
Scope docs:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | Sí | Query de búsqueda. |
limit | number | No | Cuántos devolver (1 a 100, 50 por defecto). |
curl -X GET "https://zerosoft.ai/api/v1/docs/search" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"page": {
"id": "pg_1",
"title": "Launch plan",
"icon": null,
"parentId": null,
"url": "/app/docs/pg_1",
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"archived": false
},
"snippet": "…ship the beta on Friday…"
}
]
}Servidor MCP
/api/v1/docs/mcpModel Context Protocol sobre HTTP (JSON-RPC). Métodos: initialize, tools/list, tools/call. Herramientas: search, fetch_page, create_page, update_page, list_databases, get_database, query_database, get_row, create_row, update_row, list_comments, add_comment. Las que escriben piden docs:write.
Scope docs:read
curl -X POST "https://zerosoft.ai/api/v1/docs/mcp" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "launch plan"
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "launch plan"
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"results\":[...]}"
}
],
"isError": false
}
}Notes
Leé y escribí tus notas. Una key actúa como la persona que la creó y solo ve sus notas. Las notas bloqueadas no devuelven contenido.
Listar notas
/api/v1/notesTus notas, primero las más recientes. q acepta los mismos operadores que la app (tag:, notebook:, intitle:, todo:).
Scope notes:read
curl -X GET "https://zerosoft.ai/api/v1/notes" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "note_1",
"title": "Weekly review",
"snippet": "Send the report",
"notebookId": null,
"tags": [
"work"
],
"pinned": false,
"trashed": false,
"locked": false,
"sourceUrl": null,
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z"
}
],
"hasMore": false
}Crear una nota
/api/v1/notesCrea una nota desde Markdown o bloques.
Scope notes:write
curl -X POST "https://zerosoft.ai/api/v1/notes" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Weekly review",
"markdown": "- [ ] Send the report",
"tags": [
"work"
]
}'Request
{
"title": "Weekly review",
"markdown": "- [ ] Send the report",
"tags": [
"work"
]
}Respuesta · 201
{
"data": {
"id": "note_1",
"title": "Weekly review",
"snippet": "Send the report",
"notebookId": null,
"tags": [
"work"
],
"pinned": false,
"trashed": false,
"locked": false,
"sourceUrl": null,
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"markdown": "- [ ] Send the report"
}
}Leer una nota
/api/v1/notes/:idUna nota con su contenido en Markdown y bloques.
Scope notes:read
curl -X GET "https://zerosoft.ai/api/v1/notes/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "note_1",
"title": "Weekly review",
"snippet": "Send the report",
"notebookId": null,
"tags": [
"work"
],
"pinned": false,
"trashed": false,
"locked": false,
"sourceUrl": null,
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z",
"markdown": "- [ ] Send the report"
}
}Editar una nota
/api/v1/notes/:idCambia título, etiquetas, libreta, fijado o contenido.
Scope notes:write
curl -X PATCH "https://zerosoft.ai/api/v1/notes/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"title": "Weekly review (done)",
"pinned": true
}'Request
{
"title": "Weekly review (done)",
"pinned": true
}Respuesta · 200
{
"data": {
"id": "note_1",
"title": "Weekly review",
"snippet": "Send the report",
"notebookId": null,
"tags": [
"work"
],
"pinned": true,
"trashed": false,
"locked": false,
"sourceUrl": null,
"createdAt": "2026-11-01T12:00:00.000Z",
"updatedAt": "2026-11-02T09:30:00.000Z"
}
}Mandar a la papelera
/api/v1/notes/:idMueve la nota a la papelera.
Scope notes:write
curl -X DELETE "https://zerosoft.ai/api/v1/notes/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "note_1",
"trashed": true
}
}Listar libretas
/api/v1/notes/notebooksTus libretas con su cantidad de notas.
Scope notes:read
curl -X GET "https://zerosoft.ai/api/v1/notes/notebooks" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "nb_1",
"name": "Work",
"count": 12,
"stack": null
}
]
}Servidor MCP
/api/v1/notes/mcpEndpoint de Model Context Protocol. Herramientas: search_notes, read_note, list_notebooks, list_tasks, create_note y update_note.
Scope notes:read
curl -X POST "https://zerosoft.ai/api/v1/notes/mcp" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_notes",
"arguments": {
"query": "tag:work"
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_notes",
"arguments": {
"query": "tag:work"
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"notes\":[...]}"
}
],
"isError": false
}
}Talk
Mensajería de equipo. La key actúa como la persona que la creó: ve los canales que ve esa persona y publica donde es miembro (en un canal público se une al publicar). Los mensajes directos no están en la API. Permisos talk:read y talk:write.
Listar canales
/api/v1/talk/channelsLos canales donde está la persona de la key, o con scope=all los públicos y los privados donde está.
Scope talk:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
scope | string | No | member (por defecto) o all |
q | string | No | Query de búsqueda. |
curl -X GET "https://zerosoft.ai/api/v1/talk/channels" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "tc_1",
"name": "general",
"kind": "public",
"topic": "Company news",
"description": "",
"archived": false,
"member_count": 8,
"is_member": true,
"created_at": "2026-10-25T12:00:00.000Z"
}
]
}Crear un canal
/api/v1/talk/channelsCrea un canal público o privado. El nombre se guarda como en Slack: en minúsculas y con guiones en vez de espacios.
Scope talk:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | Sí | Nombre del canal |
kind | string | No | public (por defecto) o private |
topic | string | No | Tema del canal |
curl -X POST "https://zerosoft.ai/api/v1/talk/channels" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "launch-q4",
"kind": "public",
"topic": "Q4 launch"
}'Request
{
"name": "launch-q4",
"kind": "public",
"topic": "Q4 launch"
}Respuesta · 201
{
"data": {
"id": "tc_2",
"name": "launch-q4",
"kind": "public",
"topic": "Q4 launch",
"description": "",
"archived": false,
"member_count": 1,
"is_member": true,
"created_at": "2026-10-25T12:00:00.000Z"
}
}Listar mensajes
/api/v1/talk/messagesLos mensajes del canal, del más viejo al más nuevo. Las menciones vienen como tokens con el id de la persona, más los de canal y aquí.
Scope talk:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
channel | string | Sí | Id o nombre del canal (general o #general) |
before | string | No | Fecha ISO: los mensajes anteriores (para paginar) |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/talk/messages" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "tm_1",
"channel_id": "tc_1",
"thread_id": null,
"user_id": "u_1",
"bot_name": null,
"text": "Deploy done <@u_2>",
"files": [],
"reactions": [
{
"emoji": "🎉",
"count": 2,
"users": [
"u_2",
"u_3"
]
}
],
"reply_count": 1,
"edited_at": null,
"pinned": false,
"created_at": "2026-10-25T12:05:00.000Z"
}
],
"has_more": false
}Enviar un mensaje
/api/v1/talk/messagesPublica en un canal o responde en un hilo. Menciones, avisos, vistas previas de links, Flow y webhooks corren igual que desde la app.
Scope talk:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
channel | string | Sí | Id o nombre del canal (general o #general) |
text | string | Sí | Texto del mensaje, con el mismo formato que la app (*negrita*, _itálica_, `código`, links, :emoji:) |
thread_id | string | No | Id del mensaje raíz para responder en su hilo |
also_in_channel | boolean | No | Con thread_id, mostrar la respuesta también en el canal |
curl -X POST "https://zerosoft.ai/api/v1/talk/messages" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"channel": "general",
"text": "Release *2.4* is live :tada:"
}'Request
{
"channel": "general",
"text": "Release *2.4* is live :tada:"
}Respuesta · 201
{
"data": {
"id": "tm_2",
"channel_id": "tc_1",
"thread_id": null,
"user_id": "u_1",
"bot_name": null,
"text": "Release *2.4* is live :tada:",
"files": [],
"reactions": [],
"reply_count": 0,
"edited_at": null,
"pinned": false,
"created_at": "2026-10-25T12:06:00.000Z"
}
}Webhook entrante
/api/talk/hooks/:tokenSin API key: creá la URL en un canal (Detalles, Integraciones) y mandá un POST con un JSON con text. Publica como bot con el nombre del webhook. 60 pedidos por minuto por webhook.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
text | string | Sí | Texto del mensaje, con el mismo formato que la app (*negrita*, _itálica_, `código`, links, :emoji:) |
username | string | No | Nombre del bot en el mensaje (por defecto, el del webhook) |
thread_id | string | No | Id del mensaje raíz para responder en su hilo |
curl -X POST "https://zerosoft.ai/api/talk/hooks/:token" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"text": "Build *green* on main",
"username": "CI"
}'Request
{
"text": "Build *green* on main",
"username": "CI"
}Respuesta · 200
{
"ok": true,
"id": "tm_3"
}Board
Pizarras: listarlas y buscarlas (también por el texto de adentro), leer un resumen, crearlas desde una plantilla, sumarles stickies, formas y flechas, renombrarlas, moverlas a una carpeta o mandarlas a la papelera. La key actúa como la persona que la creó: ve y edita las pizarras que esa persona puede abrir. Quien tiene la pizarra abierta ve los cambios en vivo. Scopes boards:read y boards:write.
Listar pizarras
/api/v1/boardsLas pizarras que puede abrir la persona de la key, la editada más reciente primero. Con q busca también en stickies, etiquetas y nombres de frames, y devuelve la línea que coincidió en match.
Scope boards:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Busca en el nombre y en el texto de adentro. |
folder | string | No | Id de la carpeta. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/boards" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "b_1",
"name": "Q4 retro",
"folderId": null,
"access": "workspace",
"version": 12,
"updatedAt": "2026-10-28T12:00:00.000Z",
"createdAt": "2026-10-20T09:00:00.000Z",
"updatedBy": "Ana"
}
]
}Crear una pizarra
/api/v1/boardsVacía o desde una plantilla: retro, brainstorm, userFlow, kanban, roadmap, swot, mindMap, priorityMatrix, journey o leanCanvas.
Scope boards:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | No | Nombre de la pizarra. |
template | string | No | Clave de la plantilla. |
folderId | string | No | Id de la carpeta. |
curl -X POST "https://zerosoft.ai/api/v1/boards" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Q4 retro",
"template": "retro",
"locale": "en"
}'Request
{
"name": "Q4 retro",
"template": "retro",
"locale": "en"
}Respuesta · 201
{
"data": {
"id": "b_1",
"name": "Q4 retro",
"folderId": null,
"access": "workspace",
"version": 12,
"updatedAt": "2026-10-28T12:00:00.000Z",
"createdAt": "2026-10-20T09:00:00.000Z",
"updatedBy": "Ana"
}
}Leer una pizarra
/api/v1/boards/:idLa pizarra con un resumen: frames en orden de lectura, stickies con texto y etiquetas, textos sueltos. Con scene=1, también la escena de Excalidraw.
Scope boards:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
scene | string | No | 1 para incluir la escena de Excalidraw. |
curl -X GET "https://zerosoft.ai/api/v1/boards/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": {
"id": "b_1",
"name": "Q4 retro",
"folderId": null,
"access": "workspace",
"version": 12,
"updatedAt": "2026-10-28T12:00:00.000Z",
"createdAt": "2026-10-20T09:00:00.000Z",
"updatedBy": "Ana",
"myAccess": "edit",
"outline": {
"frames": [
{
"id": "f_1",
"name": "Agenda"
}
],
"stickies": [
{
"id": "s_1",
"text": "Ship the beta",
"tags": [
"launch"
],
"frameId": null
}
],
"texts": [],
"elementCount": 14
}
}
}Modificar una pizarra
/api/v1/boards/:idLa renombra o la mueve a una carpeta (folderId null la saca).
Scope boards:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | No | Nombre de la pizarra. |
folderId | string | No | Id de la carpeta. |
curl -X PATCH "https://zerosoft.ai/api/v1/boards/:id" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"name": "Q4 retro (final)"
}'Request
{
"name": "Q4 retro (final)"
}Respuesta · 200
{
"data": {
"id": "b_1",
"name": "Q4 retro (final)",
"folderId": null,
"access": "workspace",
"version": 12,
"updatedAt": "2026-10-28T12:00:00.000Z",
"createdAt": "2026-10-20T09:00:00.000Z",
"updatedBy": "Ana"
}
}Borrar una pizarra
/api/v1/boards/:idLa manda a la papelera. Se puede restaurar desde la app durante 30 días.
Scope boards:write
curl -X DELETE "https://zerosoft.ai/api/v1/boards/:id" \
-H "Authorization: Bearer zs_live_9f3k..."Sumar stickies y formas
/api/v1/boards/:id/elementsSuma stickies, textos y formas, y flechas entre ellos por índice. Sin x e y se acomodan al lado del contenido. No cambia nada de lo que ya hay.
Scope boards:write
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
stickies | array | No | Stickies: { text, color?, tags? }. Colores: yellow, green, blue, pink, violet, orange. |
elements | array | No | Formas y textos: { kind, text?, x?, y?, width?, height?, fill? } con kind sticky, text, rectangle, ellipse o diamond. |
connect | array | No | Flechas entre elementos por índice: { from, to }. |
curl -X POST "https://zerosoft.ai/api/v1/boards/:id/elements" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"elements": [
{
"kind": "ellipse",
"text": "Start"
},
{
"kind": "rectangle",
"text": "Sign up"
}
],
"connect": [
{
"from": 0,
"to": 1
}
]
}'Request
{
"elements": [
{
"kind": "ellipse",
"text": "Start"
},
{
"kind": "rectangle",
"text": "Sign up"
}
],
"connect": [
{
"from": 0,
"to": 1
}
]
}Respuesta · 201
{
"data": {
"version": 13,
"added": [
{
"id": "e_1",
"type": "ellipse"
},
{
"id": "e_2",
"type": "rectangle"
},
{
"id": "e_3",
"type": "arrow"
}
]
}
}Servidor MCP
/api/v1/boards/mcpModel Context Protocol (streamable HTTP, respuestas JSON) para agentes de IA. Herramientas: list_boards, get_board, create_board, add_stickies, add_diagram, update_board y trash_board.
Scope boards:read
curl -X POST "https://zerosoft.ai/api/v1/boards/mcp" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "add_stickies",
"arguments": {
"board_id": "b_1",
"stickies": [
{
"text": "Ship the beta",
"color": "green"
}
]
}
}
}'Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "add_stickies",
"arguments": {
"board_id": "b_1",
"stickies": [
{
"text": "Ship the beta",
"color": "green"
}
]
}
}
}Respuesta · 200
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"version\":13,\"added\":[...]}"
}
],
"isError": false
}
}Design
Leé los diseños que ve la persona de la key: nombres, tamaños, páginas y, con id, el JSON completo de las páginas.
Listar o leer diseños
/api/v1/designSin id, los diseños que ve la persona (los más recientes primero). Con id, ese diseño con sus páginas en JSON.
Scope design:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
view | string | No | recent (por defecto), mine, shared, starred o templates |
id | string | No | Id de un diseño: devuelve ese diseño con sus páginas |
curl -X GET "https://zerosoft.ai/api/v1/design" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "d_1",
"name": "Summer sale",
"width": 1080,
"height": 1080,
"pages": 1,
"owner": "Ana",
"access": "owner",
"starred": false,
"template": false,
"updated_at": "2026-10-29T12:00:00.000Z",
"url": "https://zerosoft.ai/en/app/design/d_1"
}
]
}Shop
El catálogo y los pedidos de tu tienda. Scopes shop:read y shop:write. Los datos de clientes solo están disponibles para keys de personas con la app Shop.
Listar productos
/api/v1/shop/productsProductos con estado, rango de precio, cantidad de variantes y stock. Un POST al mismo path crea un producto con el mismo cuerpo que usa la app.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/shop/products" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "prod_1",
"handle": "blue-mug",
"title": "Blue mug",
"status": "active",
"variants": 2,
"stock": 14,
"tracked": true,
"minPriceCents": 1900,
"maxPriceCents": 2100
}
],
"total": 1
}Listar pedidos
/api/v1/shop/ordersPedidos del más nuevo al más viejo, con estado (pending, paid, fulfilled, cancelled, refunded) y total en centavos.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/shop/orders" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "ord_1",
"number": 1001,
"status": "paid",
"email": "ana@example.com",
"name": "Ana Pérez",
"totalCents": 4100,
"currency": "USD",
"paymentMethod": "stripe",
"items": 2,
"createdAt": "2026-10-29 15:00:00"
}
],
"total": 1
}Pulse
Analítica de producto. Los endpoints de ingesta (/api/ingest/*) usan la key del proyecto, no una API key: la pública (zsp_…) en el cuerpo desde el navegador, o la key secreta del proyecto como Bearer zss_… desde un servidor. Las consultas aceptan una sesión iniciada o una API key con analytics:read.
Capturar eventos
/api/ingest/eUn evento o un lote de hasta 200, 512 KB por pedido. Con la key secreta como Bearer no se chequea el origen. Los eventos con un uuid repetido se ignoran. Tiene tope por proyecto.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
api_key | string | No | Key pública del proyecto (zsp_…). También se acepta como token. |
batch | array | Sí | Eventos: event, distinct_id, properties, timestamp y un uuid opcional. Un solo evento puede ir en el primer nivel. |
sent_at | string | No | Cuándo mandó el lote el cliente; sirve para corregir su reloj. |
curl -X POST "https://zerosoft.ai/api/ingest/e" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"api_key": "zsp_…",
"batch": [
{
"event": "signed_up",
"distinct_id": "user_42",
"properties": {
"plan": "team"
},
"timestamp": "2026-10-29T12:00:00.000Z"
}
]
}'Request
{
"api_key": "zsp_…",
"batch": [
{
"event": "signed_up",
"distinct_id": "user_42",
"properties": {
"plan": "team"
},
"timestamp": "2026-10-29T12:00:00.000Z"
}
]
}Respuesta · 200
{
"status": 1,
"stored": 1,
"dropped": 0
}Feature flags de una persona
/api/ingest/decideValores de los flags activos para un distinct_id (true, false o la clave de la variante) y los ajustes del snippet. person_properties se suma a lo que la persona ya tiene.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
api_key | string | Sí | Key pública del proyecto (zsp_…). También se acepta como token. |
distinct_id | string | Sí | El id de la persona en tu producto. |
person_properties | object | No | Propiedades extra de la persona para esta evaluación. |
curl -X POST "https://zerosoft.ai/api/ingest/decide" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"api_key": "zsp_…",
"distinct_id": "user_42"
}'Request
{
"api_key": "zsp_…",
"distinct_id": "user_42"
}Respuesta · 200
{
"featureFlags": {
"new-checkout": true,
"pricing-test": "variant-b"
},
"config": {
"autocapture": true,
"respectDnt": true
}
}Borrar una persona
/api/ingest/deleteBorra a la persona de un distinct_id con todos sus eventos y sesiones. Pide la key secreta del proyecto como Bearer zss_….
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
distinct_id | string | Sí | El id de la persona en tu producto. |
curl -X POST "https://zerosoft.ai/api/ingest/delete" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"distinct_id": "user_42"
}'Request
{
"distinct_id": "user_42"
}Respuesta · 200
{
"deleted": true,
"events": 128
}Correr una consulta
/api/analytics/querykind es trends, funnel, retention, paths, sql o web. SQL es de solo lectura sobre las tablas del proyecto events, persons, person_distinct_ids y sessions, hasta 1.000 filas.
Scope analytics:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
projectId | string | Sí | Id del proyecto (ap_…). |
query | object | Sí | La definición de la consulta, la misma que guarda la app en un insight. |
curl -X POST "https://zerosoft.ai/api/analytics/query" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"projectId": "ap_…",
"query": {
"kind": "trends",
"series": [
{
"event": "$pageview",
"math": "unique"
}
],
"interval": "day",
"dateRange": {
"from": "-7d"
}
}
}'Request
{
"projectId": "ap_…",
"query": {
"kind": "trends",
"series": [
{
"event": "$pageview",
"math": "unique"
}
],
"interval": "day",
"dateRange": {
"from": "-7d"
}
}
}Respuesta · 200
{
"result": {
"kind": "trends",
"buckets": [
"2026-10-23",
"2026-10-24"
],
"series": [
{
"label": "$pageview (unique users)",
"breakdownValue": null,
"data": [
120,
134
],
"total": 231
}
],
"usedRollup": true
}
}Listar eventos
/api/analytics/eventsÚltimos eventos de un proyecto, los más nuevos primero. Pasá after con el último id que viste para traer solo los nuevos.
Scope analytics:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
project | string | Sí | Id del proyecto (ap_…). |
event | string | No | Solo este nombre de evento. |
after | number | No | Solo eventos con un id mayor. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/analytics/events" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"events": [
{
"id": 981,
"event": "$pageview",
"distinctId": "user_42",
"ts": 1761739200000,
"url": "https://example.com/pricing",
"pathname": "/pricing",
"browser": "Chrome",
"os": "macOS",
"device": "desktop",
"country": "AR",
"properties": {}
}
]
}Listar personas
/api/analytics/personsPersonas de un proyecto con sus propiedades y distinct ids, las vistas más recientemente primero.
Scope analytics:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
project | string | Sí | Id del proyecto (ap_…). |
q | string | No | Query de búsqueda. |
cohort | string | No | Solo personas de este id de cohorte. |
curl -X GET "https://zerosoft.ai/api/analytics/persons" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"persons": [
{
"id": "p_3f…",
"distinctIds": [
"user_42"
],
"properties": {
"email": "ana@example.com"
},
"isIdentified": true,
"createdAt": 1761000000000,
"lastSeen": 1761739200000
}
],
"hasMore": false
}Books
Facturas de Books. La key actúa como la persona que la creó, con su rol de Books. Los importes son enteros en la unidad mínima de la moneda (centavos). Scopes books:read y books:write.
Listar facturas
/api/v1/books/invoicesFacturas, las más nuevas primero, con estado, número, cliente, total y saldo.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
status | string | No | draft, sent, partial, paid, overdue, void, u open (todo lo que tiene saldo). |
q | string | No | Query de búsqueda. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/books/invoices" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "inv_1",
"docType": "invoice",
"status": "sent",
"numberLabel": "B 00001-00000012",
"reference": "PO 778",
"contactId": "con_1",
"contactName": "Acme SA",
"issueDate": "2026-11-01",
"dueDate": "2026-12-01",
"currency": "ARS",
"total": 12100000,
"amountDue": 12100000,
"sentAt": "2026-11-01 12:00:00",
"updatedAt": "2026-11-01 12:00:00"
}
],
"total": 1
}Crear una factura borrador
/api/v1/books/invoicesGuarda un borrador con el mismo cuerpo que usa la app. Alguien la aprueba en la app, que le da el número y genera el asiento.
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
contactId | string | No | Id del contacto de Books (el cliente). |
lines | object[] | Sí | Líneas: description, quantity, unitPrice (unidades mínimas enteras, o un texto decimal con punto como separador decimal, por ejemplo "1500.50", sea cual sea la moneda), discountBps, taxRateId, itemId. |
currency | string | No | Código de moneda ISO; si falta, la moneda base. |
fxRate | string | No | Tipo de cambio manual (moneda base por 1 unidad) cuando la moneda no es la base. |
reference | string | No | Tu referencia (orden de compra, proyecto). |
curl -X POST "https://zerosoft.ai/api/v1/books/invoices" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"contactId": "con_1",
"reference": "PO 778",
"lines": [
{
"description": "Consulting",
"quantity": 10,
"unitPrice": "1000.00",
"taxRateId": "tax_iva21"
}
]
}'Request
{
"contactId": "con_1",
"reference": "PO 778",
"lines": [
{
"description": "Consulting",
"quantity": 10,
"unitPrice": "1000.00",
"taxRateId": "tax_iva21"
}
]
}Respuesta · 201
{
"data": {
"id": "inv_2",
"docType": "invoice",
"status": "draft",
"numberLabel": "",
"total": 1210000,
"currency": "ARS",
"lines": [
{
"description": "Consulting",
"quantity": 10,
"unitPrice": 100000,
"taxBps": 2100,
"net": 1000000,
"tax": 210000,
"total": 1210000
}
]
}
}Forms
Formularios y sus respuestas. La key actúa como la persona que la creó y solo ve los formularios que esa persona puede abrir. Scope forms:read.
Listar formularios
/api/v1/forms/formsFormularios del más nuevo al más viejo, con estado, cantidad de respuestas y parciales, última respuesta y quién puede abrirlos.
Scope forms:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
q | string | No | Query de búsqueda. |
status | string | No | Filtrá los formularios por estado, por ejemplo published. |
curl -X GET "https://zerosoft.ai/api/v1/forms/forms" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "fm_1",
"name": "NPS survey",
"slug": "nps-survey-a1b2c3",
"status": "published",
"responseCount": 42,
"partialCount": 3,
"lastResponseAt": "2026-11-03T13:00:00.000Z",
"updatedAt": "2026-11-03T13:00:00.000Z",
"sharing": "workspace",
"open": true
}
]
}Listar respuestas
/api/v1/forms/responsesRespuestas de un formulario, de la más nueva a la más vieja. Las respuestas se indexan por id de pregunta. Las de archivo devuelven una referencia, no el archivo.
Scope forms:read
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
form | string | Sí | Id del formulario. |
status | string | No | completed (por defecto) o partial. |
from | string | No | Solo respuestas enviadas desde esta fecha (YYYY-MM-DD). |
to | string | No | Solo respuestas enviadas hasta esta fecha (YYYY-MM-DD). |
page | integer | No | Número de página. |
limit | number | No | Cantidad máxima de resultados. |
curl -X GET "https://zerosoft.ai/api/v1/forms/responses" \
-H "Authorization: Bearer zs_live_9f3k..."Respuesta · 200
{
"data": [
{
"id": "rs_1",
"status": "completed",
"answers": {
"q_1": 9,
"q_2": "Fast and clear"
},
"hidden": {
"source": "newsletter"
},
"vars": {
"score": 0
},
"endingId": "end_1",
"lang": "en",
"contactId": "con_1",
"consent": true,
"createdAt": "2026-11-03T12:58:00.000Z",
"submittedAt": "2026-11-03T13:00:00.000Z"
}
],
"total": 42
}Webhooks
Agregá endpoints en Dashboard → Configuración → Webhooks. Eventos: booking.created, booking.rescheduled, booking.cancelled, booking.no_show, booking.requested, link.created, link.clicked, link.updated, link.deleted, contact.created, contact.updated, deal.created, deal.updated, deal.stage_changed, deal.won, deal.lost, robot.run.finished, robot.run.failed, robot.output.changed, chat.message.created, chat.conversation.created, chat.conversation.assigned, chat.conversation.tagged, chat.conversation.resolved, chat.csat.submitted. Los eventos de links se pueden limitar a algunos links, tags o dominios. link.updated trae el link y la lista de campos que cambiaron; link.deleted, el link como estaba. Cada request lleva Zerosoft-Signature: t=TIMESTAMP,v1=HEX, donde v1 = HMAC-SHA256(secret, "TIMESTAMP.BODY_CRUDO"). Rechazá timestamps viejos. Las entregas fallidas se reintentan con backoff durante ~15 horas.
Payload del evento
https://your-app.example/webhooks/zerosoftLo que recibe tu endpoint. Respondé 2xx en menos de 8 segundos.
curl -X POST "https://your-app.example/webhooks/zerosoft" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"id": "evt_1",
"type": "booking.created",
"createdAt": "2026-11-01T18:00:00.000Z",
"data": {
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}
}'Request
{
"id": "evt_1",
"type": "booking.created",
"createdAt": "2026-11-01T18:00:00.000Z",
"data": {
"id": "8f1c2a8e-5b1e-4a7e-9a0e-2f6a1d0c9b11",
"status": "confirmed",
"startsAt": "2026-11-03T13:00:00.000Z",
"endsAt": "2026-11-03T13:30:00.000Z",
"timezone": "America/Argentina/Buenos_Aires",
"invitee": {
"name": "Ana",
"email": "ana@example.com"
},
"answers": {},
"hostUserId": "u_123",
"meetingUrl": "https://meet.google.com/abc-defg-hij",
"rescheduledFrom": null,
"cancelReason": null,
"eventType": {
"id": "et_42",
"slug": "intro",
"title": "Intro call"
}
}
}Payload de los eventos de Chat
https://your-app.example/webhooks/zerosoftLos eventos de Chat traen la conversación. chat.message.created suma el mensaje (del visitante, del equipo o del bot; las notas internas no se mandan) y chat.conversation.assigned suma previousAssignedTo.
curl -X POST "https://your-app.example/webhooks/zerosoft" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"id": "evt_2",
"type": "chat.message.created",
"createdAt": "2026-11-01T18:02:00.000Z",
"data": {
"conversation": {
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
},
"message": {
"id": "{message_id}",
"conversationId": "{conversation_id}",
"senderType": "user",
"userId": "{user_id}",
"body": "Hi Ana, the order ships tomorrow.",
"isNote": false,
"attachments": [],
"createdAt": "2026-11-01T18:02:00.000Z"
}
}
}'Request
{
"id": "evt_2",
"type": "chat.message.created",
"createdAt": "2026-11-01T18:02:00.000Z",
"data": {
"conversation": {
"id": "{conversation_id}",
"widgetId": "{widget_id}",
"status": "open",
"priority": "medium",
"subject": null,
"assignedTo": "{user_id}",
"visitor": {
"id": "{visitor_id}",
"name": "Ana",
"email": "ana@example.com"
},
"firstResponseAt": "2026-11-01T18:02:00.000Z",
"resolvedAt": null,
"createdAt": "2026-11-01T18:00:00.000Z",
"updatedAt": "2026-11-01T18:02:00.000Z"
},
"message": {
"id": "{message_id}",
"conversationId": "{conversation_id}",
"senderType": "user",
"userId": "{user_id}",
"body": "Hi Ana, the order ships tomorrow.",
"isNote": false,
"attachments": [],
"createdAt": "2026-11-01T18:02:00.000Z"
}
}
}Payload de eventos de Track
https://your-app.example/webhooks/zerosoftLos eventos issue.* traen el issue y su equipo (project en el payload); issue.status_changed suma from y to, comment.created el comentario y project.* el equipo.
curl -X POST "https://your-app.example/webhooks/zerosoft" \
-H "Authorization: Bearer zs_live_9f3k..."
-H "Content-Type: application/json" \
-d '{
"id": "evt_3",
"type": "issue.status_changed",
"createdAt": "2026-10-25T15:10:00.000Z",
"data": {
"issue": {
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"priority": "high",
"status": "Done",
"assigneeId": "{user_id}"
},
"project": {
"id": "{project_id}",
"name": "Web"
},
"changes": [
"statusId"
],
"from": "In Progress",
"to": "Done"
}
}'Request
{
"id": "evt_3",
"type": "issue.status_changed",
"createdAt": "2026-10-25T15:10:00.000Z",
"data": {
"issue": {
"id": "{issue_id}",
"identifier": "WEB-12",
"title": "Checkout button does nothing on Safari",
"priority": "high",
"status": "Done",
"assigneeId": "{user_id}"
},
"project": {
"id": "{project_id}",
"name": "Web"
},
"changes": [
"statusId"
],
"from": "In Progress",
"to": "Done"
}
}
Listar publicaciones
/api/v1/social/postsLas publicaciones que ve la key, de la más nueva a la más vieja, con el estado de cada cuenta y el link a lo publicado.
statusfromtoRespuesta · 200