Sample - Asana API
POST/projects

Create a project

Creates a new project in a workspace or team. Supply workspace to establish the project's required workspace or organization, and supply team when the workspace is an organization; use custom_fields, followers, owner, and custom_type to configure the project when applicable. A 201 response returns the complete created project record.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated fields to include in the project response, such as `archived`, `completed`, `created_at`, or `current_status`; nested fields such as `current_status.author.name` are supported.

The project to create in the data block; workspace is required, and team is also required when the workspace is an organization.

dataobjectoptional
The project details, including its workspace and any optional ownership, team, follower, custom-field, or custom-type settings.

6 status codes
201Returns the complete newly created project object.
dataobjectoptional
400Returned when a parameter or request field is missing or malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to create the project or access a referenced object.
errorsarray<object>optional
404Returned when the request action is not recognized or a referenced object does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the project from being created.
errorsarray<object>optional

Error handling

A 400 is returned when a parameter or request field is missing or malformed, including when the project lacks its required workspace. A 401 is returned when you do not provide a valid authentication token, and a 403 is returned when the authenticated user cannot create or access the project. A 404 is returned when the action is not recognized or a referenced object does not exist; a 500 indicates a server-side failure.