API de GoCliente

La API REST te deja leer y cargar información de tu estudio desde otras herramientas: planillas, sistemas propios o automatizaciones. Cada token pertenece a tu organización y solo accede a sus datos.

Crear un token

Abrí los tokens

Entrá a API Tokens y tocá Nuevo token. Necesitás permiso de configuración.

Definí el acceso

Escribí un Nombre del Token, elegí la Expiración (Sin expiración, 30 días, 90 días o 1 año) y marcá solo los Permisos (scopes) que necesita la integración.

Copiá el token

Tocá Crear token y copiá el valor. El token completo se muestra una sola vez: guardalo en un lugar seguro.

En la lista ves el estado, los alcances, el último uso y el vencimiento de cada token. Revocar lo desactiva en el momento.

Un token da acceso a los datos de tu estudio. No lo compartas ni lo publiques; si se filtra, revocalo y creá otro.

Autenticación

La URL base es https://app.gocliente.com/api. Mandá el token en el encabezado Authorization de cada pedido:

curl "https://app.gocliente.com/api/clients" \
  -H "Authorization: Bearer gck_..."

Respuesta	Qué significa
`401 Unauthorized`	Falta el token, es inválido, está revocado o venció.
`403 Forbidden`	El token no tiene el alcance que pide ese endpoint, o la persona que lo creó no tiene el permiso necesario.
`400 Bad Request`	Faltan datos o tienen un formato inválido. El detalle viene en `issues`.
`404 Not Found`	El recurso no existe o no es de tu estudio.
`409 Conflict`	Ya existe, por ejemplo un cliente con el mismo RUT.

Alcances

Alcance	Qué permite
`clients:read`	Leer el listado, la búsqueda y el historial de clientes.
`clients:write`	Crear y editar clientes.
`obligations:read`	Leer obligaciones tributarias.
`billing:read`	Leer la facturación mensual y el estado de cobranza.
`billing:write`	Registrar cobros.
`tasks:read`	Leer tareas y el tablero Kanban.
`tasks:write`	Crear, editar, mover y completar tareas.
`calendar:read`	Leer los eventos del calendario.
`calendar:write`	Crear eventos del calendario.
`notes:read`	Leer notas de seguimiento.
`notes:write`	Crear notas de seguimiento.
`org:read`	Ver la organización y el equipo.

Los tokens guardan los alcances que elegiste al crearlos. Los permisos de escritura se ejecutan con los permisos de la persona que creó el token: si esa persona no puede editar tareas en GoCliente, el token tampoco. Cada cambio queda en la auditoría a su nombre, y si deja de pertenecer al estudio el token deja de funcionar.

Endpoints

Listar clientes

GET /api/clients · alcance clients:read Busca por nombre, nombre fantasía, RUT o email, con filtro por estado.

Parámetro	Tipo	Descripción
`q`	texto	Búsqueda por nombre, nombre fantasía, RUT o email.
`status`	`activo` · `inactivo` · `all`	Estado del cliente. Por defecto, `activo`.
`limit`	número	Máximo de resultados. Por defecto 100, tope 500.
`offset`	número	Cuántos clientes saltear, para pedir la página siguiente. Por defecto 0.

La respuesta trae data (los clientes), total (cuántos hay en total con ese filtro), offset, limit y hasMore. Para recorrer toda la lista pedí páginas de limit clientes sumando limit al offset mientras hasMore sea true. Los caracteres % y _ de la búsqueda se toman como texto común.

curl "https://app.gocliente.com/api/clients?q=gonzalez&limit=20&offset=20" \
  -H "Authorization: Bearer gck_..."

Historial de un cliente

GET /api/clients/:id/audit · alcance clients:read Devuelve la auditoría de las acciones hechas sobre un cliente.

curl "https://app.gocliente.com/api/clients/clm_xxxxxx/audit" \
  -H "Authorization: Bearer gck_..."

Crear un cliente

POST /api/clients · alcance clients:write El único campo obligatorio es name (razón social). Si el RUT ya existe en el estudio, la respuesta es 409.

Campo	Tipo	Descripción
`name`	texto	Razón social, de 2 a 200 caracteres. Obligatorio.
`fantasyName`	texto	Nombre fantasía.
`taxId`	texto	RUT o CI.
`email`	texto	Correo principal. Si viene, tiene que tener formato de correo.
`monthlyFee`	número o texto	Honorario mensual. No puede ser negativo. Acepta `5000`, `"5.000"` o `"1.234,50"`.
`feeType`	texto	`IVA_INCLUIDO` o `MAS_IVA`.
`taxGroup`	texto	Grupo de certificado: `NO_CEDE`, `CEDE`, `NO_CEDE_GENERAL`, `PEQUENA_EMPRESA`, `MONOTRIBUTO`, `SERVICIOS_PERSONALES` o `SERVICIO_DOMESTICO`.
`activityStartDate`	texto	Inicio de actividad, `yyyy-mm-dd`. Una fecha que no existe (como 2026-02-31) se rechaza.
`taxPayerType`	texto	Tipo de contribuyente, por ejemplo Monotributo, SAS o SA.

curl -X POST "https://app.gocliente.com/api/clients" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Nueva Empresa SRL", "monthlyFee": 5000, "taxGroup": "CEDE"}'

Obligaciones tributarias

GET /api/obligations · alcance obligations:read

Parámetro	Tipo	Descripción
`clientId`	texto	Solo las de un cliente.
`status`	`PENDING` · `COMPLETED` · `all`	Estado. Por defecto, `all`.
`from` / `to`	fecha `aaaa-mm-dd`	Rango de vencimiento.
`limit`	número	Máximo de resultados. Por defecto 100.

curl "https://app.gocliente.com/api/obligations?status=PENDING&from=2026-10-01&to=2026-10-31" \
  -H "Authorization: Bearer gck_..."

Facturación mensual

GET /api/billing · alcance billing:read Devuelve los meses de honorarios ya registrados. Requiere month y year. Cada mes trae net, iva y total: neto más IVA es el total, lo que paga el cliente. Con summary=true suma los indicadores del mes: facturado, cobrado y pendiente (cada uno con su neto y su IVA) y tasa de cobranza. Los indicadores siguen las mismas reglas que el estado de cuenta: los meses exentos no se facturan y un mes en cero no cuenta como deuda. Un cliente fijo que todavía no tiene el mes registrado no aparece acá: para saber quién debe usá Estado de cobranza o GET /api/collections.

Parámetro	Tipo	Descripción
`month`	1 a 12	Mes. Obligatorio.
`year`	número	Año. Obligatorio.
`clientId`	texto	Solo un cliente.
`isPaid`	`true` · `false`	Filtra por estado de pago.
`summary`	`true`	Incluye los indicadores del mes.
`limit`	número	Máximo de resultados. Por defecto 200.

curl "https://app.gocliente.com/api/billing?month=10&year=2026&summary=true" \
  -H "Authorization: Bearer gck_..."

Tareas

GET /api/tasks · alcance tasks:read Lista las tareas que no son privadas. Con withColumns=true devuelve el tablero Kanban ordenado por columnas.

Parámetro	Tipo	Descripción
`withColumns`	`true`	Devuelve la estructura del tablero.
`clientId`	texto	Solo las de un cliente.
`priority`	`LOW` · `MEDIUM` · `HIGH` · `all`	Prioridad.
`assigneeId`	texto	Solo las de un integrante.
`limit`	número	Máximo de resultados. Por defecto 100.

curl "https://app.gocliente.com/api/tasks?withColumns=true" \
  -H "Authorization: Bearer gck_..."

Equipo

GET /api/team/members · alcance org:read Lista los integrantes de la organización.

curl "https://app.gocliente.com/api/team/members" \
  -H "Authorization: Bearer gck_..."

Editar un cliente

PATCH /api/clients/:id · alcance clients:write Cambia solo los campos que mandes: name, fantasyName, taxId, monthlyFee, status (activo o inactivo), entre otros. Lo que no mandás no se toca (por ejemplo, la fecha de inicio de actividad); para borrar un dato mandalo como null. Los valores inválidos (honorario negativo o con letras, fecha inexistente, correo mal escrito) devuelven 400 con el motivo, y un cliente que no existe devuelve 404.

curl -X PATCH "https://app.gocliente.com/api/clients/clm_xxxxxx" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"fantasyName": "González & Asoc.", "monthlyFee": 6500}'

Estado de cobranza

GET /api/collections · alcance billing:read Quién está al día y quién debe, con el monto y los meses pendientes de cada cliente, más los totales del estudio.

Parámetro	Tipo	Descripción
`state`	`UP_TO_DATE` · `OWES` · `NO_CHARGES`	Filtra por estado.
`q`	texto	Filtra por nombre de cliente.

curl "https://app.gocliente.com/api/collections?state=OWES" \
  -H "Authorization: Bearer gck_..."

Registrar un cobro

POST /api/payments · alcance billing:write Con month y year imputa el cobro al mes de honorarios que cancela; sin período queda como pago a cuenta. Responde 201.

Campo	Tipo	Descripción
`clientId`	texto	Cliente que paga. Obligatorio.
`amount`	número	Monto cobrado. Obligatorio.
`date`	fecha `aaaa-mm-dd`	Fecha del cobro. Obligatorio.
`paymentMethod`	`EFECTIVO` · `TRANSFERENCIA` · `DEBITO` · `CHEQUE`	Medio de pago. Obligatorio.
`currency`	`UYU` · `USD`	Moneda. Por defecto `UYU`.
`month` / `year`	números	Mes de honorarios que cancela. Van juntos.
`addIva`	`true` · `false`	Si suma el IVA 22 % a la cuota del mes. Si no lo indicás, lo define el Tipo de honorario del cliente: un cliente + IVA con cuota suma el 22 %, como en la app.
`notes`	texto	Observaciones.

curl -X POST "https://app.gocliente.com/api/payments" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"clientId": "clm_xxxxxx", "amount": 6000, "date": "2026-10-05", "paymentMethod": "TRANSFERENCIA", "month": 10, "year": 2026}'

Crear una tarea

POST /api/tasks · alcance tasks:write Pasa por las mismas reglas y automatizaciones que crear una tarea desde GoCliente. Responde 201.

Campo	Tipo	Descripción
`title`	texto	Título. Obligatorio.
`description`	texto	Descripción.
`priority`	`LOW` · `MEDIUM` · `HIGH` · `URGENT`	Prioridad. Por defecto `MEDIUM`.
`dueDate`	fecha `aaaa-mm-dd`	Vencimiento.
`clientId`	texto	Cliente al que pertenece.
`assigneeIds`	lista de textos	IDs de los responsables.
`columnId`	texto	Columna del tablero. Por defecto, la primera.

curl -X POST "https://app.gocliente.com/api/tasks" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"title": "Presentar IVA de setiembre", "priority": "HIGH", "dueDate": "2026-10-20"}'

Editar, completar o mover una tarea

PATCH /api/tasks/:id · alcance tasks:write Acepta los mismos campos que al crear. Con completed: true la completa (la mueve a la columna terminada), con completed: false la reabre, y con columnId la mueve a otra columna.

curl -X PATCH "https://app.gocliente.com/api/tasks/tsk_xxxxxx" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"completed": true}'

Notas de seguimiento

GET /api/notes · alcance notes:read Devuelve las notas visibles para quien creó el token: las públicas y sus privadas. Con clientId filtra por cliente. POST /api/notes · alcance notes:write Crea una nota de hasta 250 caracteres. Campos: text (obligatorio), clientId e isPrivate. Responde 201.

curl -X POST "https://app.gocliente.com/api/notes" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Pedir el balance", "clientId": "clm_xxxxxx"}'

Eventos del calendario

GET /api/calendar/events · alcance calendar:read Los eventos del calendario de quien creó el token. Filtrá con from y to (aaaa-mm-dd). Los vencimientos de DGI se consultan en /api/obligations. POST /api/calendar/events · alcance calendar:write Crea un evento. Responde 201.

Campo	Tipo	Descripción
`title`	texto	Título. Obligatorio.
`startDate`	fecha o fecha-hora	`aaaa-mm-dd` o con hora y zona, por ejemplo `2026-10-21T15:00:00-03:00`. Obligatorio.
`endDate`	fecha o fecha-hora	Fin, con el mismo formato.
`eventType`	`event` · `meeting` · `reminder` · `task` · `focus`	Tipo. Por defecto `event`.
`allDay`	`true` · `false`	Evento de todo el día.

curl -X POST "https://app.gocliente.com/api/calendar/events" \
  -H "Authorization: Bearer gck_..." \
  -H "Content-Type: application/json" \
  -d '{"title": "Reunión con González", "startDate": "2026-10-21T15:00:00-03:00", "eventType": "meeting"}'

¿Querés usar GoCliente desde Claude, Cursor u otro asistente sin programar nada? Mirá Conectar un asistente (MCP).

¿Necesitás un endpoint que no está en esta lista? Escribinos a hola@gocliente.com.

Empezar

Clientes

Trabajo diario

Honorarios y tesorería

Contabilidad

Portal del cliente

Equipo y seguridad

Reportes y comunicación

Integraciones

Corredores de seguros

Escribanías

Empresas (Gestión)

Ayuda

Crear un token

Autenticación

Alcances

Endpoints

Listar clientes

Historial de un cliente

Crear un cliente

Obligaciones tributarias

Facturación mensual

Tareas

Equipo

Editar un cliente

Estado de cobranza

Registrar un cobro

Crear una tarea

Editar, completar o mover una tarea

Notas de seguimiento

Eventos del calendario

​Crear un token

​Autenticación

​Alcances

​Endpoints

​Listar clientes

​Historial de un cliente

​Crear un cliente

​Obligaciones tributarias

​Facturación mensual

​Tareas

​Equipo

​Editar un cliente

​Estado de cobranza

​Registrar un cobro

​Crear una tarea

​Editar, completar o mover una tarea

​Notas de seguimiento

​Eventos del calendario

Crear un token

Autenticación

Alcances

Endpoints

Listar clientes

Historial de un cliente

Crear un cliente

Obligaciones tributarias

Facturación mensual

Tareas

Equipo

Editar un cliente

Estado de cobranza

Registrar un cobro

Crear una tarea

Editar, completar o mover una tarea

Notas de seguimiento

Eventos del calendario