API: conectar Zapier, Make y tus sistemas

Crear una clave

1. Abre Configuración de la empresa › Integraciones › API. Solo dueños y admins la ven.
2. Toca Crear clave, ponle un nombre (por ejemplo, Zapier) y elige Solo lectura o Lectura y escritura.
3. Copia la clave en el momento y guárdala en un lugar seguro: aparece una sola vez. gridOS guarda solo su comienzo (gk_live_a1b2…) para que la reconozcas en la lista.

Si una clave se filtra o ya no se usa, toca Revocar. Las apps que la usan dejan de funcionar al instante. No se puede deshacer, pero puedes crear otra.

Dirección y autenticación

Todas las llamadas van a:

https://pookurdrdvkpvnmwlwch.supabase.co/functions/v1/api/v1/

Envía la clave en el encabezado Authorization: Bearer gk_live_…. Las respuestas son JSON, con los campos en camelCase (por ejemplo, dueDate y companyId). Una lista llega como {"data": [...], "next": ...}; un elemento, como {"data": {...}}.

Qué se puede hacer

Leer (cualquier clave):

• GET clients · GET clients/{id}: clientes
• GET projects · GET projects/{id}: proyectos (filtros: companyId, status)
• GET tasks · GET tasks/{id}: tareas (filtros: projectId, status = todo, doing o done, updatedSince)
• GET invoices · GET invoices/{id}: facturas (filtros: status, companyId, projectId)
• GET proposals · GET proposals/{id}: propuestas

Crear y cambiar (clave de lectura y escritura):

• POST clients: name, y si quieres email, phone, contact. El cliente entra como prospecto.
• POST projects: name y companyId (sin cliente, es un proyecto interno).
• POST tasks: title, y si quieres projectId, dueDate y assigneeEmail (el e-mail de alguien del estudio).
• PATCH tasks/{id}: title, status (todo, doing o done) y dueDate (null quita la fecha).

Fechas con el formato 2026-10-25. Ejemplo, crear una tarea:

curl -X POST https://pookurdrdvkpvnmwlwch.supabase.co/functions/v1/api/v1/tasks \
  -H "Authorization: Bearer gk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "Revisar logo", "dueDate": "2026-10-25", "assigneeEmail": "ana@estudio.com"}'

Páginas, límites y errores

• Las listas vienen de las más nuevas a las más antiguas, 50 por vez (hasta 100 con limit=100). Cuando hay más, la respuesta trae next: envíalo de vuelta como cursor=… para la página siguiente. También funciona offset.
• Hasta 120 llamadas por minuto por clave. Por encima, la respuesta es 429: espera un poco e inténtalo de nuevo.
• Hasta 20 claves activas por estudio.
• Los errores llegan como {"error": {"code": ..., "message": ...}}: 401 clave incorrecta o revocada, 403 clave de solo lectura intentando cambiar algo, 404 no encontrado, 400 algún campo incorrecto.

Zapier y Make

Usa las dos piezas juntas:

• Para empezar cuando algo pasa en gridOS (propuesta aceptada, factura pagada, cliente nuevo…), usa los webhooks en Integraciones › Avanzado. En Zapier, el disparador Webhooks by Zapier › Catch Hook; en Make, el módulo Webhooks › Custom webhook. Pega la dirección que te den en un webhook nuevo de gridOS.
• Para hacer algo en gridOS (crear un cliente, una tarea…), usa la API. En Zapier, la acción Webhooks by Zapier › Custom Request; en Make, el módulo HTTP › Make a request. Pon la dirección con la ruta (por ejemplo, …/api/v1/tasks), el método, el encabezado Authorization y el cuerpo en JSON.

Crea una clave por herramienta. Así, si necesitas revocar una, las demás siguen funcionando.