Claim an email domain
POST /v1/domains
New users who sign in with a verified email on a claimed domain join this org as members. An owner may claim the domain of their own verified email; public mailbox domains cannot be claimed. Each domain belongs to at most one org.
Credential. A dashboard session token belonging to an owner of the organisation.
curl --fail-with-body -X POST "https://api-833252724876.us-central1.run.app/v1/domains" \
-H "Authorization: Bearer $JEAN_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"domain": "example.com"
}'
Body
| Field | Type | Required | Notes |
|---|---|---|---|
domain | string | yes | Lower-case. Must be the domain of the caller's own verified email. Length 3–253. |
Response · 201
{
"org_id": "org_k3j2h4g5f6d7s8a9q0w1",
"domain": "example.com",
"claimed_by": "usr_b2c3d4e5f6g7h8i9j0k1",
"verified_at": "2026-01-15T09:30:00Z",
"created_at": "2026-01-15T09:30:00Z"
}
Errors
| Status | Meaning |
|---|---|
401 | Unauthenticated, invalid token or revoked key. |
403 | Forbidden, session required or org required. |
409 | Already exists, or stale version. |
422 | Validation failed. |
429 | Quota or rate limit exceeded; error.details says which, and when. |
500 | Internal error; quote error.request_id when reporting it. |
Every one carries the same envelope.