¿Por qué recibo 403 unverified_workspace_recipient?

Este artículo explica el error 403 Workspace not verified que reciben los espacios de trabajo nuevos cuando envían a direcciones externas, y cómo levantar la restricción.

Síntomas

POST /v2/emails devuelve 403 con un cuerpo como este:

{
  "code": "unverified_workspace_recipient",
  "error": "Workspace not verified",
  "message": "Unverified workspaces can only send to workspace members' account emails. Blocked recipient: ada@example.com.",
  "blocked_recipients": ["ada@example.com"]
}

También puedes ver:

• SMTP rechaza el destinatario con 550 Unverified workspaces can only send to workspace members' account emails.
• Las campañas fallan con Unverified workspaces cannot send campaigns.
• El panel muestra el aviso This workspace is not verified. Emails can only be sent to workspace members’ account emails.

Causa

Todo espacio de trabajo nuevo empieza sin verificar, en modo sandbox. Hasta que el equipo de Emailit aprueba el acceso de producción del espacio de trabajo:

• Solo puedes enviar a las direcciones de email de cuenta de los miembros del espacio de trabajo, es decir, las direcciones con las que inician sesión. Las invitaciones pendientes no cuentan.
• Si alguna dirección de to, cc o bcc está fuera de esa lista, se rechaza toda la petición y no se cobra ningún crédito. El array blocked_recipients lista las direcciones que lo han provocado.
• No se pueden enviar campañas.

Así se protege la reputación de envío compartida frente al abuso de cuentas recién creadas.

Solución

1. Verifica un dominio de envío. El acceso de producción requiere al menos un dominio verificado. Añade uno en Email API›Domains y publica sus registros. Consulta Añadir un dominio.

2. Abre el formulario de solicitud. Selecciona Request production access en el aviso del panel, o ve a Workspace›Settings, abre Requests y elige Request Workspace Verification. Solo los administradores del espacio de trabajo pueden enviarla.

3. Describe tus envíos con sinceridad. Elige el tipo de email (Transactional, Marketing o ambos), la URL de tu sitio web, el volumen mensual previsto y el caso de uso, explica cómo consigues los destinatarios y marca las casillas de cumplimiento normativo. Las respuestas concretas se aprueban antes.

4. Sigue el hilo de la solicitud. La solicitud muestra Pending Review mientras el equipo la revisa. Si cambia a Awaiting Your Reply, responde a la pregunta en el hilo. Cuando pasa a Approved, la restricción se levanta de inmediato.

5. Sigue probando mientras tanto. Envía a tu propio email de cuenta, o invita a compañeros para que sus direcciones queden permitidas cuando acepten. Consulta ¿Cómo pruebo los envíos antes de que se verifique mi espacio de trabajo?.

Lee Acceso de producción para conocer el proceso de revisión completo, y Errores de la API para otras respuestas 403.

¿Sigues teniendo problemas?

Si tu solicitud lleva tiempo pendiente, responde en el hilo de la solicitud, contacta con soporte o pregunta en Discord.