Skip to content
Torii docs

Invite a user to an organization by email. Caller must be owner or admin.

POST
/_torii/organizations/{organizationId}/invitations
curl --request POST \
--url https://your-app.torii.so/_torii/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/invitations \
--header 'Content-Type: application/json' \
--data '{ "email": "hello@example.com", "role": "example" }'
organizationId
required
string format: uuid
Media type application/json
object
email
required
string format: email
>= 1 characters
role
required
string
>= 1 characters
Example generated
{
"email": "hello@example.com",
"role": "example"
}

OK

Media type application/json
object
id
required
string format: uuid
organizationId
required
string format: uuid
email
required
string
role
required
string
token
required
string
expiresAt
required
string format: date-time
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"email": "example",
"role": "example",
"token": "example",
"expiresAt": "2026-04-15T12:00:00Z"
}