Skip to main content
POST
Create a team

Authorizations

Authorization
string
header
required

Body

application/json
title
string
required
Maximum string length: 200
Example:

"Customer Success"

slug
string
required

The address of the team's public page. Turned into a URL-safe form (lowercase, hyphens) and unique across every team and user.

Example:

"customer-success"

timezone
string
required

IANA time zone.

Example:

"Europe/Berlin"

country
string

ISO 3166-1 alpha-2 country code. On create it defaults to the country of timezone; a zone with no country, such as UTC, needs it.

Example:

"DE"

welcomeMessage
string | null

Shown on the team's public page. HTML is removed.

Maximum string length: 300

Response

Created

success
boolean
Example:

true

status
integer
Example:

201

team
object

A team of the workspace with its member and manager counts. GET /teams/{teamId}/members lists the members.

Last modified on November 1, 2026