Cuando ejecutas campañas de correo electrónico o sincronizas contactos entre tu aplicación y un ESP, necesitas una regla clara: quién está permitido para recibir correo y quién debe ser excluido. verify-email.app no reemplaza el enlace de cancelación de suscripción de tu ESP ni el cumplimiento legal, pero te proporciona reglas de lista negra y lista blanca que aparecen en cada respuesta de verificación como un único campo: block. Tu código puede leer block antes de enviar, importar una lista o crear una cuenta, sin copiar la lógica de permitir/bloquear en cada servicio.

• Lista Negra — Si el correo electrónico o su dominio está en tu lista negra, la API devuelve block: true. Usa esto para personas que se dieron de baja, casos de abuso o dominios a los que nunca deseas enviar correos.

• Lista Blanca — Cuando el modo lista blanca está activado, solo las direcciones (o dominios completos) que agregaste a la lista blanca obtienen block: false. Todos los demás obtienen block: true. Usa esto para listas cerradas: socios, invitaciones, betas internas, no para un boletín de “cualquiera puede suscribirse”.

• Orden — La lista negra prevalece. Si una dirección está en la lista negra, permanece bloqueada incluso si también aparece en la lista blanca.

1. Cuando un usuario cancela la suscripción en tu aplicación o procesas un webhook de ESP, toma su dirección (o el dominio que bloqueas por política).

2. Añádelo con POST /v1/blacklist y cuerpo JSON {"value": "[email protected]"} (o "ejemplo.com" para bloquear todas las direcciones en ese dominio). Usa el encabezado X-API-Key con tu clave de API.

3. Antes de enviar una campaña o empujar una fila a tu herramienta de correo, verifica la dirección. Si block es verdadero, omite ese destinatario.

Para permitirlos nuevamente más tarde (por ejemplo, si se re-suscribieron y confirmaron), elimina la regla con DELETE /v1/[email protected].

1. Activa el modo estricto de solo permitir: PUT /v1/whitelist/enabled con cuerpo {"enabled": true}.

2. Agrega cada dirección o dominio aprobado: POST /v1/whitelist con {"value": "[email protected]"} o {"value": "empresa.com"}.

3. Al verificar, block: false significa que la dirección está permitida bajo tu lista blanca; otros están bloqueados hasta que los agregues.

Cuando no necesites el modo de solo permitir (por ejemplo, vuelve el registro público), configura enabled de nuevo a false para que la lista blanca deje de restringir a todos los demás.

La mayoría de los productos almacenan el consentimiento en el ESP y mantienen una lista de supresión allí. En verify-email.app usualmente eliminan la dirección de la lista negra si se habían dado de baja antes (DELETE en lista negra), luego confían en tu ESP para el estado real de suscripción. Reserva la lista blanca para flujos donde solo los correos electrónicos preaprobados pueden pasar.

Puedes administrar las mismas reglas en el panel de control así como a través de la API—consulta las páginas de Lista Negra y Lista Blanca en verify-email.app para contexto y detalles de la API.