Skip to main content

Invite or update an organization member

POST 
/members

Invites a person by email, or updates the license and org role of an existing member with that email, like the Invite members dialog of the Members page.

A new member gets the invitation email unless send_invite_email is false, also when the organization uses single sign-on. Workspaces listed in project_ids give them Workspace Member access (Workspace Viewer for an Org Viewer) in restricted workspaces where they have no access yet. Org Admins already have Workspace Admin access to every workspace, so project_ids changes nothing for them; give an Org Admin a lower role in a workspace with PUT /members/{membership_id}/projects/{project_id}.

The license and org role have to match: a Viewer license is always an Org Viewer, and an Editor license is an Org Admin or an Org Member. The Org Owner's license and org role can't be changed. Invitations count towards the same invite rate limits as the Members page and answer with 429 when one is reached.

Request​

Responses​

OK