Skip to main content
POST
/
api
/
directory
/
teams.create
Create a team
curl --request POST \
  --url https://api.example.com/api/directory/teams.create \
  --header 'Content-Type: application/json' \
  --data '
{
  "parent_id": "872815618512410358",
  "name": "<string>",
  "id": "872815618512410358",
  "short_name": "<string>",
  "color": "<string>",
  "external_id": "<string>"
}
'
{
  "id": "872815618512410358"
}

Body

application/json
parent_id
string<snowflake>
required
Example:

"872815618512410358"

name
string
required
id
string<snowflake>
Example:

"872815618512410358"

short_name
string

Should be provided only for sectors

color
string

Should be provided only for sectors

external_id
string

Response

201 - application/json

Team successfully created.

id
string<snowflake>
Example:

"872815618512410358"