Sample - Asana API
POST/teams

Create a team

Creates a new team within the current workspace. Supply the team details in data, including the team name and any supported description, organization, visibility, and access settings. Creating a team returns the newly created team object.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated list of optional team properties to include in the response, including nested custom field settings and custom field details.

The team to create, including its name and supported team configuration and access settings.

dataobjectoptional
Team details for the new team. The complete object includes the team's name, description, organization, visibility, and access settings.

6 status codes
201Returns the newly created team object, including its team details and configured settings.
dataobjectoptional
400Returned when a required or other request parameter is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to create the team.
errorsarray<object>optional
404Returned when the request action or referenced object does not exist.
errorsarray<object>optional
500Returned when a problem occurs on the server; the response may include an error phrase.
errorsarray<object>optional

Error handling

A 400 is returned when the team data or another request parameter is missing or malformed, and a 401 is returned when no valid authentication token is provided. A 403 is returned when the authenticated user lacks permission to create the team, and a 404 is returned when the request action or referenced object does not exist. A 500 indicates a server-side problem; retrieving the complete team object requires the teams:read scope.