CRM API

La CRM API de Mirlo te permite gestionar oportunidades de venta, pipelines, tickets de soporte, contactos y cuentas de tu organizacion de forma programatica.

URL Base

https://api.mirlo.com/v1/crm/organizations/{organization_id}

Autenticacion

Todas las requests requieren autenticacion. El organization_id va en el path de cada endpoint.

API Key

curl https://api.mirlo.com/v1/crm/organizations/{organization_id}/tickets \
  -H "X-API-Key: <YOUR_API_KEY>"

JWT Bearer Token

curl https://api.mirlo.com/v1/crm/organizations/{organization_id}/tickets \
  -H "Authorization: Bearer eyJhbGci..."

Podes obtener tu API Key en Mi Organizacion → API Keys en el dashboard de Mirlo.

Productos

Oportunidades

Crear y gestionar oportunidades de venta con productos, etapas y conversaciones

Pipelines

Configurar pipelines de ventas, etapas, monedas y tipos de cambio

Tickets

Crear, listar y gestionar tickets de soporte

Contactos

CRUD de contactos con identidades (telefono, email)

Cuentas

Gestionar cuentas/empresas y vincular contactos

Tareas

Crear y gestionar tareas asociadas a oportunidades, tickets y contactos

Paginacion

Todas las listas usan paginacion con limit y offset:

{
  "data": [...],
  "total": 142,
  "limit": 20,
  "offset": 0
}

Errores

Todas las respuestas de error siguen el mismo formato:

{
  "statusCode": 404,
  "error": {
    "message": "No Ticket found",
    "error": "Not Found",
    "statusCode": 404
  }
}

Codigo	Significado
`400`	Parametros invalidos o faltantes
`401`	API key o JWT invalido
`403`	Sin permiso para esta organizacion
`404`	Recurso no encontrado
`409`	Conflicto (ej: contacto duplicado)
`500`	Error interno del servidor