Al terminar esta guía, sabrás cómo identificar las empresas de lemlist cuya sincronización con el CRM está bloqueada por un conflicto de dominio duplicado, reasignar sus contactos al registro correcto y automatizar todo el flujo de trabajo de limpieza con la API de lemlist, sin ningún trabajo manual en la interfaz de lemlist.

Cuando los contactos no se pueden sincronizar con tu CRM, tu equipo de ventas trabaja con datos incompletos. Los negocios se quedan sin seguimiento, las cuentas no aparecen en HubSpot, Salesforce o Pipedrive, y los huecos en el pipeline pasan desapercibidos: el comercial no ve ningún error. UNIQUE_INDEX_ERROR_COMPANY es una de las causas más habituales, y en los equipos con bases de datos de contactos grandes puede bloquear cientos de registros a la vez sin que nadie lo note.

El error se produce porque lemlist usa el dominio de la empresa como identificador único al sincronizar. Si dos empresas de lemlist comparten el mismo dominio, solo se sincroniza correctamente la primera. Todos los contactos vinculados a la segunda quedan bloqueados hasta que resuelvas el conflicto.

lemlist ya no guarda un dominio de email personal (gmail.com, yahoo.com, outlook.com y otros proveedores habituales) como dominio de empresa, por lo que las empresas nuevas ya no se crean con uno. Las empresas creadas a partir de un dominio personal antes de este cambio no se actualizan de forma retroactiva, y este flujo de trabajo sigue aplicándose a ellas.

Sin acceso a la API, la única solución es manual: abrir cada duplicado en la interfaz de lemlist y corregirlos uno a uno. Los tres endpoints de esta guía te permiten automatizar todo el proceso y ejecutarlo de forma programada, para que los nuevos conflictos se resuelvan antes de que tu equipo llegue a notarlos.

Si tu espacio de trabajo tiene activada la replicación de fusiones del CRM, al fusionar dos empresas en HubSpot o Salesforce, la empresa correspondiente de lemlist se integra automáticamente en la que se conserva: los contactos, el historial, las tareas, las entradas en campañas y las listas se transfieren, y el duplicado se elimina. En ese caso basta con hacer la limpieza en tu CRM y no necesitas este flujo de trabajo.

Esta guía sigue siendo útil cuando:

La replicación de fusiones se está implementando de forma progresiva y no está activa en todos los espacios de trabajo. Contacta con el equipo de asistencia si no sabes si se aplica al tuyo.

Tres endpoints hacen todo el trabajo. Antes de crear tu automatización, dedica unos minutos a entender qué devuelve cada uno: así la Fase 2 te resultará mucho más clara.

El nuevo parámetro de consulta crmSyncStatus filtra las empresas según su estado de sincronización. Pasa unique_index_error_company para obtener solo las empresas bloqueadas por un conflicto de dominio.

Otros valores admitidos para crmSyncStatus: synced, not_synced, error, property_doesnt_exist, required_field_missing, company_already_exists_with_name, company_already_exists_with_linkedin_url.

Ahora, cada empresa de la respuesta incluye un bloque crmSync:

alreadyExistingCompanyId es la empresa de lemlist que ya ocupa el slot del CRM en conflicto: es la empresa a la que reasignarás los contactos en el paso 3.

💡 Este campo hace el trabajo difícil por ti. En lugar de adivinar qué empresa es la correcta, la API te lo indica directamente: es la que ya se sincroniza con tu CRM.

Cuatro nuevos filtros, mutuamente excluyentes, te permiten listar todos los contactos vinculados a una empresa concreta. Pasa uno de ellos:

Las variantes de dominio y URL se convierten internamente en un companyId. Si no se encuentra ninguna coincidencia, el endpoint devuelve una lista vacía, no un 404.

💡 Estos filtros también son útiles más allá de la limpieza de duplicados: cualquier equipo que haga prospección basada en cuentas puede usarlos para obtener todos los contactos de un dominio de empresa sin necesidad de conocer el ID interno.

Elimina un registro de empresa de lemlist. Si todavía hay contactos vinculados, la solicitud se rechaza con un error 400 COMPANY_HAS_CONTACTS que incluye un contactCount.

Pasa ?force=true para desvincular todos los contactos antes de la eliminación. Los contactos desvinculados se quedan sin companyId. La respuesta incluye unlinkedContacts: N, que confirma cuántos se desvincularon. Usa esta opción cuando no sea necesario reasignar los contactos; por ejemplo, si el duplicado contenía registros de prueba o contactos que no quieres conservar.

Ahora que sabes qué hace cada endpoint, encadénalos en orden. Estas cuatro llamadas a la API resuelven automáticamente todos los conflictos de duplicados. Ejecútalas manualmente para una limpieza puntual o prográmalas cada noche en n8n, Zapier o Make.

Para cada resultado, extrae dos valores del bloque crmSync:

Ahora tienes dos ID por conflicto: la empresa que hay que eliminar y la empresa a la que hay que reasignar los contactos. Una sola llamada a la API te da la visión completa de todas las empresas bloqueadas de tu espacio de trabajo.

Esto devuelve todos los contactos vinculados actualmente a la empresa duplicada.

Antes de reasignar, necesitas una lista completa de los contactos afectados. Ejecuta esta llamada una vez por cada empresa bloqueada del paso 1: recorre cada resultado y reúne todos los contactos que hay que mover.

Para cada contacto devuelto en el paso 2, haz un upsert por email y establece companyId con la empresa correcta:

La reasignación vincula cada contacto a la empresa que ya se sincroniza con tu CRM. Tras este paso, el contacto pertenece a la cuenta correcta y se sincronizará en el siguiente ciclo del CRM.

Con todos los contactos reasignados, el duplicado ya no tiene registros vinculados y se puede eliminar sin problemas. Así se resuelve el conflicto de dominio: las próximas sincronizaciones de la empresa correcta se completarán sin errores. Si te saltaste el paso 3, usa ?force=true para desvincular y eliminar en una sola llamada, pero ten en cuenta que los contactos desvinculados no tendrán ninguna empresa asociada hasta que los reasignes.

Así es como funciona en la práctica. El equipo de revenue operations de una empresa SaaS B2B descubre que faltan más de 200 contactos en HubSpot. Tras revisar los registros de sincronización en Settings → Integrations → HubSpot → Logs, encuentra 14 empresas marcadas con UNIQUE_INDEX_ERROR_COMPANY, todas con dominios compartidos con empresas que ya estaban en su CRM tras una importación masiva de datos realizada varios meses antes.

En lugar de abrir cada duplicado en la interfaz de lemlist y corregirlos uno a uno, lo que les habría llevado buena parte del día, crean un flujo de trabajo de cuatro pasos en n8n:

La primera ejecución resuelve los 14 conflictos y desbloquea los más de 200 contactos, que aparecen en HubSpot en el siguiente ciclo de sincronización. El equipo programa el flujo de trabajo para que se ejecute cada noche. Durante las dos semanas siguientes, detecta y resuelve automáticamente tres conflictos nuevos, que el equipo no habría notado hasta que un comercial avisara de que faltaban datos.

Causa: todavía hay contactos vinculados; el paso 3 no se ejecutó o no se completó para todos los contactos.

Causa: el tipo de conflicto es diferente. Este campo solo aparece con unique_index_error_company; los demás motivos de error tienen metadatos distintos.

Causa: puede que el contacto esté vinculado a otra empresa que también tiene errores de sincronización, o que el CRM necesite unos minutos para procesar los cambios.

Causa: DELETE /api/companies solo elimina el registro de lemlist; no modifica tu CRM.