Orgs / Teams
Create a team
Getting Started
Platform / Cal Provider
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Event Types
Orgs / Memberships
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Memberships
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Schedules
Orgs / Users / OOO
Orgs / Webhooks
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Orgs / Teams
Create a team
POST
/
v2
/
organizations
/
{orgId}
/
teams
curl --request POST \
--url https://api.cal.com/v2/organizations/{orgId}/teams \
--header 'Content-Type: application/json' \
--header 'x-cal-client-id: <x-cal-client-id>' \
--data '{
"name": "CalTeam",
"slug": "caltel",
"logoUrl": "https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": false,
"isPrivate": true,
"hideBookATeamMember": true,
"metadata": "<string>",
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png",
"timeFormat": 123,
"timeZone": "America/New_York",
"weekStart": "Monday",
"autoAcceptCreator": true
}'
{
"status": "success",
"data": {
"id": 123,
"parentId": 123,
"name": "<string>",
"slug": "<string>",
"logoUrl": "<string>",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": true,
"isOrganization": true,
"isPrivate": true,
"hideBookATeamMember": false,
"metadata": "<string>",
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "<string>",
"timeFormat": 123,
"timeZone": "Europe/London",
"weekStart": "Sunday"
}
}
Headers
Path Parameters
Body
application/json
Name of the team
Minimum length:
1
Team slug
URL of the teams logo image
URL of the teams banner image which is shown on booker
Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed.
Response
201 - application/json
Available options:
success
, error
Minimum length:
1
Was this page helpful?
curl --request POST \
--url https://api.cal.com/v2/organizations/{orgId}/teams \
--header 'Content-Type: application/json' \
--header 'x-cal-client-id: <x-cal-client-id>' \
--data '{
"name": "CalTeam",
"slug": "caltel",
"logoUrl": "https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": false,
"isPrivate": true,
"hideBookATeamMember": true,
"metadata": "<string>",
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png",
"timeFormat": 123,
"timeZone": "America/New_York",
"weekStart": "Monday",
"autoAcceptCreator": true
}'
{
"status": "success",
"data": {
"id": 123,
"parentId": 123,
"name": "<string>",
"slug": "<string>",
"logoUrl": "<string>",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": true,
"isOrganization": true,
"isPrivate": true,
"hideBookATeamMember": false,
"metadata": "<string>",
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "<string>",
"timeFormat": 123,
"timeZone": "Europe/London",
"weekStart": "Sunday"
}
}