Řešení problémů

Proč dostávám chybu 403 unverified_workspace_recipient?

Nové workspace mohou posílat e-maily jen svým členům, dokud nedostanou produkční přístup. Zjistěte, proč API vrací 403 a jak workspace ověřit.

Aktualizováno 1. 10. 2026

Tento článek vysvětluje chybu 403 Workspace not verified, kterou dostávají nové workspace, když posílají e-maily na externí adresy, a jak toto omezení zrušit.

Příznaky

POST /v2/emails vrací 403 s tělem odpovědi, jako je toto:

JSON

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

Můžete také vidět:

SMTP odmítne příjemce s 550 Unverified workspaces can only send to workspace members' account emails.
Kampaně selžou s chybou Unverified workspaces cannot send campaigns.
Webové rozhraní ukazuje banner This workspace is not verified. Emails can only be sent to workspace members’ account emails.

Příčina

Každý nový workspace začíná jako neověřený, v sandboxu. Dokud tým Emailitu workspace neschválí pro produkční přístup:

Můžete posílat e-maily jen na e-mailové adresy účtů členů workspace, tedy na adresy, kterými se lidé přihlašují. Nevyřízené pozvánky se nepočítají.
Pokud je kterákoli adresa v to, cc nebo bcc mimo tento seznam, odmítne se celý požadavek a neúčtují se žádné kredity. Pole blocked_recipients uvádí adresy, které odmítnutí způsobily.
Kampaně nelze odesílat vůbec.

Chrání to sdílenou reputaci odesílání před zneužitím úplně novými účty.

Řešení

Ověřte odesílací doménu. Produkční přístup vyžaduje alespoň jednu ověřenou doménu. Přidejte ji v Email APIDomains a publikujte její záznamy. Viz Přidání odesílací domény.
Otevřete formulář žádosti. Vyberte Request production access v banneru webového rozhraní, nebo přejděte do WorkspaceSettings, otevřete Requests a zvolte Request Workspace Verification. Žádost mohou odeslat jen administrátoři workspace.
Popište své odesílání pravdivě. Zvolte typ e-mailů (Transactional, Marketing nebo oba), uveďte URL webu, očekávaný měsíční objem a způsob použití, vysvětlete, jak získáváte příjemce, a zaškrtněte potvrzení souladu s předpisy. Konkrétní odpovědi se schvalují rychleji.
Sledujte vlákno žádosti. Žádost má stav Pending Review, dokud ji tým posuzuje. Pokud se změní na Awaiting Your Reply, odpovězte na otázku ve vlákně. Jakmile má stav Approved, omezení se okamžitě zruší.
Mezitím dál testujte. Posílejte e-maily na e-mailovou adresu svého účtu, nebo pozvěte kolegy, aby jejich adresy byly povolené, jakmile pozvánku přijmou. Viz Jak otestuji odesílání, než bude můj workspace ověřený?

Celý proces posouzení popisuje stránka Produkční přístup a další odpovědi 403 najdete na stránce Chyby API.

Stále si nevíte rady?

Pokud vaše žádost čeká už delší dobu, odpovězte ve vlákně žádosti, napište podpoře nebo se zeptejte na Discordu.