Join an organization

Join an organization if the user's verified email domain matches one of the organization's allowed email domains. This endpoint allows existing users to join organizations they're eligible for based on their email domain.

Available in MCP

post

Authorizations

user

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

Responses

204

Successfully joined the organization

No content

400

User's email domain is not valid

application/json

404

Organization not found

application/json

post/orgs/{organizationId}/join

HTTPcURLJavaScriptPython

POST /v1/orgs/{organizationId}/join HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content