Error codes
invites.principal_email_unavailable
The accepting principal's WorkOS profile did not return an email — required for the invite-email match check.
invites.principal_email_unavailable is returned at HTTP 403.
When this fires
WorkOS sessions occasionally lack an email claim (admin SSO setups that strip it). Without an email the server cannot run the invites.email_mismatch check, so it fails closed.
What to do
Reconfigure your WorkOS connection to release the email claim, then re-attempt the invite. Org admins can debug this from the WorkOS dashboard's connection logs.
See also
- SDK reference — the Python and TypeScript SDKs raise typed exceptions for codes in this namespace.
- Error code index — every code the runtime can return.