Los endpoints antiguos de la API de bajas se retiran a partir del 1 de noviembre de 2026. Después de esa fecha, las llamadas a estos endpoints dejan de funcionar, así que todos los flujos que todavía los usan (tu propio código, Zapier, Make, n8n) deben apuntar a los endpoints de bajas multicanal v2 para seguir funcionando sin interrupciones. Este artículo indica la ruta que sustituye a cada ruta antigua, enumera los cambios en las respuestas que pueden romper tu código actual y presenta las nuevas rutas a nivel de contacto y masivas.
¿Por qué cambia?
La función de bajas se desarrolló originalmente cuando el email era el único canal disponible en lemlist. Ahora que hay varios canales disponibles, el sistema de bajas se ha rediseñado para gestionarlos.
Este rediseño también incorpora una forma de dar de baja a nivel de contacto, lo que garantiza que no se envíe ninguna comunicación futura desde ningún canal, incluidos los canales que se añadan a la plataforma más adelante.
Antes de empezar
Las llamadas a los endpoints antiguos dejan de funcionar a partir del 1 de noviembre de 2026.
Las rutas antiguas solo aceptan emails y dominios. Las URL de LinkedIn y los números de teléfono solo se pueden dar de baja a través de v2.
No puedes volver a suscribir una variable cuyo origen sea
leadoabuse. Estos orígenes están protegidos y devuelven409.El parámetro
limitde la ruta de lista acepta un máximo de 100.Una solicitud de baja masiva acepta hasta 10,000 valores.
Necesitas:
Una clave de API de lemlist: consulta Encuentra y usa la API de lemlist.
Una lista de todos los scripts, integraciones y automatizaciones que llaman actualmente a una ruta
/unsubscribes.
Conceptos clave
Variable: un valor de contacto que puedes dar de baja. Existen cuatro tipos: email, dominio (empieza por @), URL de LinkedIn y número de teléfono.
Contacto: una persona identificada por un
contactId(prefijocon_). Al dar de baja un contacto, se activa el indicadordoNotContact, que bloquea todos los canales. La ruta GET Contact muestra este indicador en el campo booleanounsubscribed.Origen (source): el origen de una baja. Valores posibles:
api,bounced,lead,user,abuse.Idempotencia: dar de baja una variable que ya está dada de baja devuelve el registro existente con el código
200.
Fase 1: Sustituye cada llamada antigua por su equivalente v2
Estos cinco endpoints se retiran y cada uno tiene un sustituto directo. Cambia la ruta y mantén la misma finalidad.
POST /unsubscribes/{email}→POST /v2/unsubscribes/variables/{value}(Unsubscribe Variable)GET /unsubscribes/{email}→GET /v2/unsubscribes/variables/{value}(Get Unsubscribed Variable)GET /unsubscribes→GET /v2/unsubscribes/variables(List Unsubscribed Variables)DELETE /unsubscribes/{email}→DELETE /v2/unsubscribes/variables/{value}(Re-subscribe Variable)GET /unsubs/export→GET /v2/unsubscribes/exports/variables(Export Unsubscribed Variables)
✅ Verificación: una llamada a la ruta v2 devuelve 200 con el registro, y la misma llamada a la ruta antigua ya no se usa en ninguna parte de tu flujo.
Fase 2: Adapta tu código a los cambios en las respuestas
Estos cambios pueden romper el código de cliente existente. Comprueba cada punto en tu integración actual.
POST variable: se elimina el campo
email. Leevalueen su lugar. La respuesta también añadevariableysource.GET variable: la respuesta ya no incluye
createdAt. Un valor inexistente devuelve404con"Variable not found". Un valor vacío devuelve400en lugar de500.DELETE variable: la respuesta es la cadena de texto simple
"Variable subscribed", no un objeto JSON. Un valor inexistente devuelve400en lugar de404. Un origen protegido devuelve409.GET list: el formato no cambia. Ten en cuenta que el parámetro
limitahora acepta un máximo de 100.Exportación CSV: se añade la columna
_iden la primera posición. Las columnas pasan a ser_id, value, source, createdAt.
Una actualización futura cambiará las rutas que devuelven una cadena de texto simple, por ejemplo "Variable not found" o "Variable subscribed". Estas rutas devolverán JSON. Este cambio estandariza la API. No hagas que tu código dependa del texto exacto.
✅ Verificación: nada en tu código lee email de una respuesta POST, depende del texto exacto de la respuesta DELETE ni asigna las columnas de la exportación por posición.
Fase 3: Actualiza tus webhooks
Desde el 30 de marzo de 2026, la baja de un contacto ya no emite emailsUnsubscribed.
En su lugar, suscríbete a entityUnsubscribed (contacto completo) o a variableUnsubscribed (una sola variable).
Fase 4: Aprovecha las novedades de v2 (opcional)
Ahora puedes dar de baja de forma masiva:
POST /v2/unsubscribes/variables→ Bulk Unsubscribe Variables
También tienes acceso a nuevos endpoints que gestionan las bajas a nivel de contacto en lugar de por canal:
GET /v2/unsubscribes/contacts/{contactId}→ Get Contact Subscription StatusPOST /v2/unsubscribes/contacts/{contactId}→ Unsubscribe ContactDELETE /v2/unsubscribes/contacts/{contactId}→ Re-subscribe ContactGET /v2/unsubscribes/exports/contacts→ Export Unsubscribed Contacts
Ejemplo
Un formulario de tu sitio web da de baja a personas, y tu script lee el email de la respuesta para registrarlo.
Antes: POST /unsubscribes/{email} y, después, lee email de la respuesta.
Después: POST /v2/unsubscribes/variables/{value} y, después, lee value. También recibes variable y source. Si ese valor ya está dado de baja, recibes el registro existente con 200, así que no necesitas comprobarlo antes.
Si quieres bloquear a esa persona en todos los canales y no solo en una dirección de email, llama a POST /v2/unsubscribes/contacts/{contactId} en su lugar. Esto activa doNotContact en el contacto.
Solución de problemas
Problema: 404 con "Variable not found" en un GET que antes funcionaba.
Causa: el valor no está dado de baja, y v2 devuelve un 404 donde tu código esperaba la respuesta antigua.
Solución: trata 404 como "este valor no está dado de baja" y no como un error, y elimina cualquier lectura de createdAt en esa respuesta.
Problema: 409 al volver a suscribir una variable.
Causa: la variable se dio de baja desde un origen protegido: lead o abuse.
Solución: lee el campo source antes de intentar volver a suscribir, omite los orígenes protegidos y gestiona 409 sin reintentar.
Problema: tu llamada DELETE falla al procesar la respuesta.
Causa: actualmente la respuesta es la cadena de texto simple "Variable subscribed" en lugar de un objeto JSON, y pasará a ser JSON en una actualización futura.
Solución: escribe el procesamiento de la respuesta de modo que acepte tanto una cadena de texto simple como un objeto JSON, y nunca bases la lógica en el texto exacto. Básate en el código de estado y espera 400 en lugar de 404 cuando el valor no exista.
Problema: falta el email en la respuesta después de una baja.
Causa: el campo email se eliminó de la respuesta de POST variable.
Solución: lee value en su lugar.
Si tu caso es diferente
Si gestionas las bajas dentro de lemlist y no a través de la API, consulta Usa la sección de bajas.
Si tus bajas se envían a un CRM, consulta Sincroniza las bajas entre lemlist y tu CRM.
Si primero necesitas crear o encontrar una clave de API, consulta Encuentra y usa la API de lemlist.
Este cambio requiere algo de trabajo por tu parte, así que contacta con el equipo de asistencia o con tu Account Manager asignado si necesitas ayuda adicional.
