Organization Memberships

Create a new organization membership

Changed on

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

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/organizations/{organization_id}/memberships
  • Auth: HTTP bearer

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.

Changes

  • 2025-11-10a490313abffaRevision changes
    • warning

      removed the optional property ///// from the response with the status

  • 2025-11-107db12d6a9b2aRevision changes
    • info

      added the optional property ///// to the response with the status