Contactos

Listar contactos

GET /api/v1/crm/contacts

Parámetros:

Nombre	Tipo	Descripción
cursor	string	Cursor de paginación
limit	int	Items por página (default 25, máx 100)
filter[owner_id]	string	UUID del propietario
filter[account_id]	string	UUID de la cuenta
filter[source]	string	manual, import, api, web_form
filter[tag]	string	Filtrar por tag
search	string	Búsqueda por nombre o email
sort	string	-created_at, last_name, -updated_at

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "account_id": "uuid",
      "customer_id": "uuid",
      "owner_id": "uuid",
      "email": "[email protected]",
      "first_name": "María",
      "last_name": "García",
      "phone": "+51 999 123 456",
      "job_title": "Gerente de compras",
      "source": "manual",
      "tags": ["vip", "b2b"],
      "metadata": {},
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ],
  "meta": { "pagination": { "cursor": "eyJ...", "has_next": true, "limit": 25 } }
}

---

Crear contacto

POST /api/v1/crm/contacts

{
  "email": "[email protected]",
  "first_name": "María",
  "last_name": "García",
  "phone": "+51 999 123 456",
  "job_title": "Gerente de compras",
  "account_id": "uuid",
  "source": "api",
  "tags": ["vip"],
  "metadata": {}
}

Respuesta 201: objeto Contact completo.

---

Obtener contacto

GET /api/v1/crm/contacts/:id

---

Actualizar contacto

PATCH /api/v1/crm/contacts/:id

Mismos campos que crear. Omite los campos que no quieras cambiar.

---

Eliminar contacto

DELETE /api/v1/crm/contacts/:id

Respuesta 204 No Content