Pourquoi l’API renvoie-t-elle l’erreur 403 unverified_workspace_recipient ?

Cet article explique l’erreur 403 Workspace not verified que reçoivent les nouveaux espaces de travail lorsqu’ils envoient à des adresses externes, et comment lever cette restriction.

Symptômes

POST /v2/emails renvoie 403 avec un corps comme celui-ci :

{
  "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"]
}

Vous pouvez aussi constater les signes suivants :

• SMTP rejette le destinataire avec 550 Unverified workspaces can only send to workspace members' account emails.
• Les campagnes échouent avec Unverified workspaces cannot send campaigns.
• Le tableau de bord affiche la bannière This workspace is not verified. Emails can only be sent to workspace members’ account emails.

Cause

Chaque nouvel espace de travail démarre non vérifié, en mode bac à sable. Tant que l’équipe Emailit n’a pas approuvé l’accès production de l’espace de travail :

• Vous ne pouvez envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail, c’est-à-dire les adresses que les membres utilisent pour se connecter. Les invitations en attente ne comptent pas.
• Si une adresse to, cc ou bcc ne figure pas dans cette liste, toute la requête est rejetée et aucun crédit n’est débité. Le tableau blocked_recipients liste les adresses en cause.
• Les campagnes ne peuvent pas être envoyées du tout.

Cette règle protège la réputation d’envoi partagée contre les abus de comptes tout juste créés.

Solution

1. Vérifiez un domaine d’envoi. L’accès production nécessite au moins un domaine vérifié. Ajoutez-en un dans Email API›Domains et publiez ses enregistrements. Consultez Ajouter un domaine.

2. Ouvrez le formulaire de demande. Sélectionnez Request production access dans la bannière du tableau de bord, ou accédez à Workspace›Settings, ouvrez Requests et choisissez Request Workspace Verification. Seuls les administrateurs de l’espace de travail peuvent envoyer la demande.

3. Décrivez vos envois avec sincérité. Choisissez le type d’e-mails (Transactional, Marketing ou les deux), indiquez l’URL de votre site web, le volume mensuel prévu et votre cas d’usage, expliquez comment vous recueillez vos destinataires, et cochez les cases de conformité. Les réponses précises sont approuvées plus vite.

4. Suivez le fil de la demande. La demande affiche Pending Review pendant que l’équipe l’examine. Si elle passe à Awaiting Your Reply, répondez à la question dans le fil. Dès qu’elle est Approved, la restriction est levée.

5. Continuez vos tests en attendant. Envoyez à l’adresse e-mail de votre compte, ou invitez des collègues : leurs adresses seront autorisées dès qu’ils auront accepté l’invitation. Consultez Comment tester l’envoi avant la vérification de mon espace de travail ?.

Consultez Accès production pour le processus d’examen complet et Erreurs de l’API pour les autres réponses 403.

Le problème persiste ?

Si votre demande est en attente depuis un moment, répondez dans le fil de la demande, contactez le support ou posez votre question sur Discord.