Create an organization

POST

auth

orgs

A valid request URL is required to generate request examples

{
  "id": "01M6PCKTR8BV4A31YRF50Q2QAE",
  "slug": "quarterly-report",
  "name": "Ada Lovelace",
  "metadata": {},
  "role": "owner",
  "created_at": "2026-11-05T17:37:56.488561+00:00"
}

Authorizations

apikey

string

header

required

Your publishable (pb_pk_…) or secret (pb_sk_…) key.

Authorization

string

header

required

The signed-in person's access token.

Body

application/json

slug

string

required

URL-safe unique id.

Pattern: ^[a-z0-9][a-z0-9-]{1,62}$

name

string

required

Display name.

Required string length: 1 - 200

metadata

Metadata · object

Free-form JSON the application attaches to this record.

Response

Created. The body is the new object.

string

required

Unique identifier.

slug

string

required

name

string

required

The name.

metadata

object

required

Free-form metadata attached by the application.

role

string

required

created_at

string<date-time>

required

When it was created (UTC).

A valid request URL is required to generate request examples

{
  "id": "01M6PCKTR8BV4A31YRF50Q2QAE",
  "slug": "quarterly-report",
  "name": "Ada Lovelace",
  "metadata": {},
  "role": "owner",
  "created_at": "2026-11-05T17:37:56.488561+00:00"
}

Storage

AI

Flows

Inbound webhooks

Health

Accounts and sign-in

Social sign-in

Company sign-in (SAML)

Two-step verification

Sessions

Organizations and teams

User API keys

Devices

Realtime

Create an organization

Authorizations

Body

Response