ClonifyDevelopersIr al panel

Empezar

  • Autenticación
  • Errores
  • Paginación
  • Límites de peticiones
  • Webhooks
  • Para agentes de IA
  • Servidor MCP

Referencia de la API

  • Seguimiento de alumnos6
  • Entregas externas por API6
  • Chat con el clon1
  • Contactos y etiquetas5
  • Accesos de academias4
  • Conversaciones4
  • Catálogo de productos11
  • Ventas externas2
  • Conocimiento12
  • Multimedia4
  • Clones (versions en la API)3
  • Reuniones y reservas3
  • Webinars6
  • Cuenta y consumo1
Clonify

Contactos y etiquetas

GET/api/v1/contacts

Listar contactos

Exporta tus contactos con sus etiquetas (y la caducidad de cada una).

Parámetros de consulta

limitinteger 1..200
starting_afterinteger

Cursor: devuelve contactos con id mayor que este.

bash
curl "https://www.clonify.com/api/v1/contacts" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "object": "list",
  "data": [{
    "object": "contact",
    "id": 3,
    "email": "ana@example.com",
    "name": "Ana Pérez",
    "phone": null,
    "source": "visitor",
    "tags": [{ "name": "Alumna Curso X", "color": "blue", "expires_at": null }],
    "conversation_count": 4,
    "first_seen_at": "2026-05-01T10:00:00.000Z",
    "last_seen_at": "2026-07-01T09:30:00.000Z",
    "created_at": "2026-05-01T10:00:00.000Z",
    "updated_at": "2026-07-01T09:30:00.000Z"
  }],
  "has_more": true,
  "next_starting_after": 3
}
POST/api/v1/contacts

Crear o actualizar un contacto

Importa un contacto desde tu sistema. Idempotente por email: si ya existe, enriquece los campos vacíos y suma las etiquetas. Para sincronizar cursos o membresías externas usa el protocolo de Accesos; esta ruta queda para CRM, segmentación e integraciones anteriores.

Permiso de escritura

Cuerpo (JSON)

emailstringobligatorio
namestring
phonestring
tagsstring[] (máx 20 × 255)

Etiquetas a añadir (máx. 20; 255 caracteres por nombre). Las que no existan se crean.

remove_tagsstring[] (máx 20 × 255)

Etiquetas a RETIRAR en esta llamada (máx. 20; 255 caracteres por nombre).

expires_atISO 8601 | null

Fecha final de las etiquetas de esta llamada (ISO 8601). Si se omite, conserva las fechas existentes y aplica la duración del producto a sus nuevas etiquetas de acceso. null concede acceso de por vida. Una fecha explícita actualiza el vencimiento.

bash
curl -X POST "https://www.clonify.com/api/v1/contacts" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"email":"…"}'
GET/api/v1/contacts/{id}

Leer un contacto

Un contacto concreto con sus etiquetas.

Parámetros de ruta

idintegerobligatorio
bash
curl "https://www.clonify.com/api/v1/contacts/1" \
  -H "Authorization: Bearer clk_live_…"
DELETE/api/v1/contacts/{id}

Borrar un contacto

Borra el contacto PERMANENTEMENTE, con sus notas y etiquetas. Sus conversaciones NO se borran. Pensado para sincronizar bajas desde tu sistema (RGPD, limpieza del CRM).

Permiso de borrado

Parámetros de ruta

idintegerobligatorio
bash
curl -X DELETE "https://www.clonify.com/api/v1/contacts/1" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'
json
{ "id": 3, "deleted": true }
GET/api/v1/tags

Listar etiquetas

Tu catálogo de etiquetas con su significado para el clon (clon_context), el producto enganchado y el nº de contactos.

bash
curl "https://www.clonify.com/api/v1/tags" \
  -H "Authorization: Bearer clk_live_…"
json
{
  "object": "list",
  "data": [{
    "object": "tag",
    "id": 24569,
    "name": "Alumna Curso X",
    "color": "blue",
    "clon_context": "Es alumna del Curso X",
    "product_id": 172,
    "contact_count": 41
  }],
  "has_more": false,
  "next_starting_after": null
}