Ir al contenido

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.

MétodoRutaDescripción
POST/contacts/bulkCrear contactos en lote
PATCH/contacts/bulk-updateActualizar en lote
DELETE/contacts/bulk-deleteEliminar en lote
POST/contacts/import/check-duplicatesVerificar duplicados antes de importar
POST/contacts/exportExportar contactos (hasta 1000 filas; devuelve las filas, no un archivo)
GET/contacts/tagsListar etiquetas del workspace
POST/contacts/tagsCrear una etiqueta
POST/contacts/:contactId/tagsAgregar etiquetas (por tagId) a un contacto
DELETE/contacts/:contactId/tags/:tagIdQuitar una etiqueta de un contacto
GET/contacts/:contactId/notesListar notas
POST/contacts/:contactId/notesAgregar una nota
PATCH/contacts/:contactId/notes/:noteIdEditar una nota
DELETE/contacts/:contactId/notes/:noteIdEliminar una nota
GET/contacts/:contactId/remindersListar recordatorios
POST/contacts/:contactId/remindersCrear un recordatorio
GET/contacts/:contactId/activityLínea de tiempo de actividad
GET/contacts/:contactId/scoreScore/temperatura del contacto
GET/custom-propertiesListar propiedades personalizadas
POST/custom-propertiesCrear una propiedad personalizada

POST /contacts/export recibe en el cuerpo:

CampoTipoRequeridoDescripción
columnsstring[]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>.
filtersobjectNostatuses, assignedUserIds y tagIds (arreglos). Un arreglo vacío no filtra.
sortBy / sortOrderstringNoMismo orden que el listado de contactos.
limitnumber | nullNoMá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.

POST/workspaces/:workspaceId/contacts/:contactId/notes
CampoTipoRequeridoDescripción
contentstringSíTexto de la nota.