Create a team
POST/teams
Create a team.
auto_assign_online: true makes assigning the team immediately hand the
conversation to a random online member — AI agents count as always online.
humans_only: true keeps AI agents out of the team entirely.
Teams are a plan capability: a plan without agent groups answers 402. Names are
unique per account, compared case-insensitively, so a duplicate answers 409.
Request
Responses
- 201
- 400
- 401
- 402
- 403
- 409
Team created.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
A plan ceiling or a locked feature stopped an otherwise valid request.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was valid but conflicts with the current state.
Response Headers
Correlation id for this request. Quote it when reporting a problem.