Contactos
Contactos — etiquetas, notas y bulk
Además del CRUD básico (se abre en una pestaña nueva), los contactos exponen operaciones para etiquetas, notas, recordatorios y acciones masivas. Todas cuelgan de /workspaces/:workspaceId/contacts.
Endpoints
Sección titulada «Endpoints»| Método | Ruta | Descripción |
|---|---|---|
POST | /contacts/bulk | Crear contactos en lote |
PATCH | /contacts/bulk-update | Actualizar en lote |
DELETE | /contacts/bulk-delete | Eliminar en lote |
POST | /contacts/import/check-duplicates | Verificar duplicados antes de importar |
POST | /contacts/export | Exportar contactos (hasta 1000 filas; devuelve las filas, no un archivo) |
GET | /contacts/tags | Listar etiquetas del workspace |
POST | /contacts/tags | Crear una etiqueta |
POST | /contacts/:contactId/tags | Agregar etiquetas (por tagId) a un contacto |
DELETE | /contacts/:contactId/tags/:tagId | Quitar una etiqueta de un contacto |
GET | /contacts/:contactId/notes | Listar notas |
POST | /contacts/:contactId/notes | Agregar una nota |
PATCH | /contacts/:contactId/notes/:noteId | Editar una nota |
DELETE | /contacts/:contactId/notes/:noteId | Eliminar una nota |
GET | /contacts/:contactId/reminders | Listar recordatorios |
POST | /contacts/:contactId/reminders | Crear un recordatorio |
GET | /contacts/:contactId/activity | Línea de tiempo de actividad |
GET | /contacts/:contactId/score | Score/temperatura del contacto |
GET | /custom-properties | Listar propiedades personalizadas |
POST | /custom-properties | Crear una propiedad personalizada |
Exportar contactos
Sección titulada «Exportar contactos»POST /contacts/export recibe en el cuerpo:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
columns | string[] | Sí | Columnas en el orden del archivo. Nativas (name, email, phone, status, source, assignedUser, tags, company, city, createdAt…) o propiedades personalizadas con el prefijo custom:<key>. |
filters | object | No | statuses, assignedUserIds y tagIds (arreglos). Un arreglo vacío no filtra. |
sortBy / sortOrder | string | No | Mismo orden que el listado de contactos. |
limit | number | null | No | Máximo de filas (1–1000). null o sin enviar: hasta el tope de 1000. |
Devuelve { columns: [{ key, label }], rows: string[][], total, exported, truncated }. Las filas ya vienen formateadas; truncated es true si el tope dejó contactos fuera. Las notas no se exportan.
Ejemplo — agregar una nota
Sección titulada «Ejemplo — agregar una nota»POST
/workspaces/:workspaceId/contacts/:contactId/notesCuerpo de la petición
Sección titulada «Cuerpo de la petición»| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
content | string | Sí | Texto de la nota. |
