Create Team
Creates a new team for the authenticated user, populated with the given team members. Hidden teams cannot be created via the REST API.
Whether the requesting user is automatically added to the team depends on the permission type. With user permissions, the user is automatically added to the team. With admin permissions, the user is not automatically added.
Headers
If the requesting user is an account owner, team admin, or team manager with the required permissions and they make the request with the value of “admin” as this header and include an admin scope, the request will be made using their admin permissions.
Request body
Example request
{
"name": "Team Name",
"type": "open",
"users": [
321,
654,
987
]
}Response
Created. Returns a Team resource containing information about the created team. If requesting as admin, the user making the request will not have been automatically included as a user on the team.
Example response
{
"id": 123456789,
"name": "Team Name",
"type": "open",
"created": "2024-01-30T16:29:37Z"
}