Ir al contenido principal

Migra de los endpoints de bajas antiguos a la API de bajas v2

Las antiguas rutas /unsubscribes dejan de funcionar el 1 de noviembre de 2026. Aquí tienes la ruta que sustituye a cada llamada, los cambios en las respuestas que rompen el código existente y las nuevas opciones a nivel de contacto y masivas.

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 lead o abuse. Estos orígenes están protegidos y devuelven 409.

  • El parámetro limit de 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 (prefijo con_). Al dar de baja un contacto, se activa el indicador doNotContact, que bloquea todos los canales. La ruta GET Contact muestra este indicador en el campo booleano unsubscribed.

  • 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. Lee value en su lugar. La respuesta también añade variable y source.

  • GET variable: la respuesta ya no incluye createdAt. Un valor inexistente devuelve 404 con "Variable not found". Un valor vacío devuelve 400 en lugar de 500.

  • DELETE variable: la respuesta es la cadena de texto simple "Variable subscribed", no un objeto JSON. Un valor inexistente devuelve 400 en lugar de 404. Un origen protegido devuelve 409.

  • GET list: el formato no cambia. Ten en cuenta que el parámetro limit ahora acepta un máximo de 100.

  • Exportación CSV: se añade la columna _id en 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 Status

  • POST /v2/unsubscribes/contacts/{contactId} → Unsubscribe Contact

  • DELETE /v2/unsubscribes/contacts/{contactId} → Re-subscribe Contact

  • GET /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

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.

¿Ha quedado contestada tu pregunta?