Sample - Asana API
POST/teams/{team_gid}/projects

Create a project in a team

Creates a new project shared with the specified team. Provide the new project in the request body and use opt_fields to request additional properties in the returned project. A 201 response returns the complete newly created project record.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated response properties to include, including nested properties such as `current_status.author.name`; omit this parameter to use the default response fields.

The new project to create, including project attributes and optional team, workspace, owner, follower, custom field, and custom type associations.

dataobjectoptional

6 status codes
201Returns the newly created project record.
dataobjectoptional
400Returned when a parameter or project body value is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to create the project or access the requested objects.
errorsarray<object>optional
404Returned when the requested action, team, or referenced object does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents project creation.
errorsarray<object>optional

Error handling

A 400 is returned when the project body or another parameter is missing or malformed. A 401 is returned when no valid authentication token is provided, and a 403 is returned when the authenticated user lacks permission to create the project or the required projects:write scope. A 404 indicates that the team or another referenced object does not exist, while a 500 indicates a server-side failure.