Sample - Slack Web API
POST/admin.teams.create

Create an Enterprise team

Creates an Enterprise team. Supply team_domain and team_name, and optionally provide its description and discoverability setting. If provided, team_discoverability must be open, closed, invite_only, or unlisted.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 4 body fields
tokenstringrequired
Authentication token with the `admin.teams:write` scope.

Enterprise team creation data containing the required team identity fields and optional settings.

team_domainstringrequired
Team domain (for example, slacksoftballteam).
team_namestringrequired
Team name (for example, Slack Softball Team).
team_descriptionstringoptional
Description for the team.
team_discoverabilitystringoptional
Who can join the team. A team's discoverability can be `open`, `closed`, `invite_only`, or `unlisted`.

2 status codes
200Returns a successful response with `ok` set to true.
okbooleanrequired
Allowed:true
defaultReturns the standard failure response with `ok` set to false.
okbooleanrequired
Allowed:false

Error handling

team_domain and team_name must both be provided. When supplied, team_discoverability must be one of open, closed, invite_only, or unlisted, and token must carry the admin.teams:write scope.