v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB

Organization Memberships

Create a new organization membership

Adds a user as a member to the given organization. Only users in the same instance as the organization can be added as members.

This organization will be the user's [active organization] (https://clerk.com/docs/organizations/overview#active-organization) the next time they create a session, presuming they don't explicitly set a different organization as active before then.

post/organizations/{organization_id}/memberships

Path parameters

organization_idstring required

The ID of the organization where the new membership will be created

Request body

user_idstring required

The ID of the user that will be added as a member in the organization. The user needs to exist in the same instance as the organization and must not be a member of the given organization already.

rolestring required

The role that the new member will have in the organization.

public_metadataobject nullable

Metadata saved on the organization membership, that is visible to both your frontend and backend.

private_metadataobject nullable

Metadata saved on the organization membership that is only visible to your backend.

Response

Success

idstring required

object'organization_membership' required

String representing the object's type. Objects of the same type share the same value.

rolestring required

role_namestring

permissionsstring[] required

public_metadataobject required

Metadata saved on the organization membership, accessible from both Frontend and Backend APIs

private_metadataobject

Metadata saved on the organization membership, accessible only from the Backend API

created_atinteger required

Unix timestamp of creation.

updated_atinteger required

Unix timestamp of last update.