Docs

createOrganization()

Creates an Organization.

function createOrganization: (params: CreateParams) => Promise<Organization>;
  • Name
    name
    Type
    string
    Description

    Name of the organization.

  • Name
    createdBy
    Type
    string
    Description

    The user ID for the user creating the organization. The user will become an administrator for the organization.

  • Name
    slug?
    Type
    string
    Description

    Slug of the organization.

  • Name
    publicMetadata?
    Type
    Record<string, unknown>
    Description

    Metadata saved on the organization, that is visible to both your Frontend and Backend APIs.

  • Name
    privateMetadata?
    Type
    Record<string, unknown>
    Description

    Metadata saved on the organization that is only visible to your Backend API.

const name = 'test-org';

const createdBy = 'user_2V7JJKmoA9HqzHhfMqK5cpgLl56';

const response = await clerkClient.organizations.createOrganization({ name, createdBy });

console.log(response);
/*
_Organization {
  id: 'org_2b6TtF4XlxDsKo6t0E0UyywGB72',
  name: 'test-org',
  slug: 'test-org-1705534741',
  imageUrl: 'https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yVjdKRFdyclJwRmZFZTlqQUM2dWpSMG8xSlQiLCJyaWQiOiJvcmdfMmI2VHRGNFhseERzS282dDBFMFV5eXdHQjcyIiwiaW5pdGlhbHMiOiJUIn0',
  hasImage: false,
  createdBy: 'user_2V7JJKmoA9HqzHhfMqK5cpgLl56',
  createdAt: 1705534741971,
  updatedAt: 1705534741971,
  publicMetadata: {},
  privateMetadata: {},
  maxAllowedMemberships: 3,
  adminDeleteEnabled: true,
  members_count: undefined
}
*/

Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint POST/organizations. See the BAPI reference for more details.

Feedback

What did you think of this content?