Skip to main content
POST
/
v2
/
organizations
/
{orgId}
/
organizations
Create an organization within an organization
curl --request POST \
  --url https://api.cal.com/v2/organizations/{orgId}/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "CalTeam",
  "apiKeyDaysValid": 60,
  "apiKeyNeverExpires": true,
  "slug": "cal-tel",
  "metadata": {
    "key": "value"
  }
}
'
{
  "status": "success",
  "data": {
    "id": 123,
    "name": "<string>",
    "apiKey": "<string>",
    "slug": "<string>",
    "metadata": {
      "key": "value"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-cal-secret-key
string

For platform customers - OAuth client secret key

​
x-cal-client-id
string

For platform customers - OAuth client ID

Path Parameters

​
orgId
number
required

Body

application/json
​
name
string
required

Name of the organization

Minimum string length: 1
Example:

"CalTeam"

​
apiKeyDaysValid
number
default:30

For how many days is managed organization api key valid. Defaults to 30 days.

Required range: x >= 1
Example:

60

​
apiKeyNeverExpires
boolean

If true, organization api key never expires.

Example:

true

​
slug
string

Organization slug in kebab-case - if not provided will be generated automatically based on name.

Example:

"cal-tel"

​
metadata
object

You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.

Example:
{ "key": "value" }

Response

201 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object
required