Sample - Asana API
POST/workspaces/{workspace_gid}/projects

Create a project in a workspace

Creates a new project in the specified workspace. Provide the project details in the request body and use opt_fields to select additional properties in the returned project. If the workspace is an organization, supply team to share the project with a team.

  • 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 in the workspace, including project attributes and optional team, owner, follower, custom field, and custom type associations.

dataobjectoptional

6 status codes
201Returns the newly created project record in the specified workspace.
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, workspace, 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, including an organization workspace request without the required team association. 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 workspace or another referenced object does not exist, while a 500 indicates a server-side failure.