Skip to main content
POST
Create a team

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Body

application/json
name
string
required

Team display name.

Required string length: 1 - 255
Example:

"Growth Team"

slug
string

Optional URL slug. Generated from name when omitted on create.

Required string length: 1 - 100
Example:

"growth-team"

bio
string | null

Optional team biography or description.

Example:

"Team managing growth and acquisition programs."

logoUrl
string<uri> | null

Optional public logo URL.

Example:

"https://cdn.example.com/team-logo.png"

hideTeamBranding
boolean
default:false

Whether team branding should be hidden in booking pages.

Example:

false

Whether team profile links should be hidden publicly.

Example:

false

isTeamPrivate
boolean
default:false

Whether team resources are private by default.

Example:

false

hideBookATeamMember
boolean
default:false

Whether booking a specific team member is disabled.

Example:

false

theme
string | null

Optional UI theme preference for team pages.

Example:

"light"

brandColor
string | null

Optional primary brand color hex value.

Example:

"#2563eb"

darkBrandColor
string | null

Optional dark-mode brand color hex value.

Example:

"#1e3a8a"

timeFormat
integer | null

Preferred time format. Allowed values: 12 or 24.

Required range: 12 <= x <= 24
Example:

24

timeZone
string
default:Asia/Kolkata

IANA timezone identifier used for team scheduling defaults.

Example:

"Asia/Kolkata"

weekStart
string
default:Monday

Week start day label used for calendar preferences.

Example:

"Monday"

metadata
any

Arbitrary metadata payload associated with the team.

Example:
bookingFrequency
any

Optional booking frequency configuration payload.

Example:

Response

Team created successfully

Team created successfully

success
enum<boolean>
required
Available options:
true
data
object
message
string
meta
object