Create a project

Create a new project in a workspace or team.

Every project is required to be created in a specific workspace or
organization, and this cannot be changed once set. Note that you can use
the workspace parameter regardless of whether or not it is an
organization.

If the workspace for your project is an organization, you must also
supply a team to share the project with.

Returns the full record of the newly created project.

Query Params
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Body Params

The project to create.

object

A project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.

Responses

Response body
object
object

A project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization and is accessible to a subset of users in that workspace or organization, depending on its permissions.

string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.

boolean

True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.

string | null

Color of the project.

dark-pink dark-green dark-blue dark-red dark-teal dark-brown dark-orange dark-purple dark-warm-gray light-pink light-green light-blue light-red light-teal light-brown light-orange light-purple light-warm-gray none

date-time

The time at which this resource was created.

object | null

Deprecated: new integrations should prefer the current_status_update resource.

object | null

The latest status_update posted to this project.

array of objects

Array of Custom Field Settings (in compact form).

custom_field_settings
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

object

Deprecated: new integrations should prefer the parent field. The id of the project that this custom field settings refers to.

boolean

is_important is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.

object

The parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.

object

The custom field that is applied to the parent.

string

The default view (list, board, calendar, or timeline) of a project.

list board calendar timeline

date | null

Deprecated: new integrations should prefer the due_on field.

date | null

The day on which this project is due. This takes a date with format YYYY-MM-DD.

string

Opt In. The notes of the project with formatting as HTML.

array of objects

Array of users who are members of this project.

members
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

Read-only except when same user as requester. The user’s name.

date-time

The time at which this project was last modified.
Note: This does not currently reflect any changes in associations such as tasks or comments that may have been added or removed from the project.

string

Free-form textual information associated with the project (ie., its description).

boolean
deprecated

Deprecated: new integrations use privacy_setting instead.

string

The privacy setting of the project. Note: Administrators in your organization may restrict the values of privacy_setting.

public_to_workspace private_to_team private

date | null

The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format. Note: due_on or due_at must be present in the request when setting or unsetting the start_on parameter. Additionally, start_on and due_on cannot be the same date.

string

The default access for users or teams who join or are added as members to the project.

admin editor commenter viewer

string

The minimum access level needed for project members to modify this project's workflow and appearance.

admin editor

string

The minimum access level needed for project members to share the project and manage project memberships.

admin editor

array of objects

Array of Custom Fields.

custom_fields
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the custom field.

string

Deprecated: new integrations should prefer the resource_subtype field. The type of the custom field. Must be one of the given values.

text enum multi_enum number date people

array of objects

Conditional. Only relevant for custom fields of type enum. This array specifies the possible values which an enum custom field can adopt. To modify the enum options, refer to working with enum options.

enum_options
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the enum option.

boolean

Whether or not the enum option is a selectable value for the custom field.

string

The color of the enum option. Defaults to ‘none’.

boolean

Conditional. Determines if the custom field is enabled or not.

string

This field tells the type of the custom field.

text enum multi_enum number date people formula custom_id

string | null

This field is the unique custom ID string for the custom field.

boolean

Conditional. This flag describes whether a custom field is a formula custom field.

object | null

Conditional. Only relevant for custom fields of type date. This object reflects the chosen date (and optionally, time) value of a date custom field. If no date is selected, the value of date_value will be null.

object | null

Conditional. Only relevant for custom fields of type enum. This object is the chosen value of an enum custom field.

array of objects

Conditional. Only relevant for custom fields of type multi_enum. This object is the chosen values of a multi_enum custom field.

multi_enum_values
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

The name of the enum option.

boolean

Whether or not the enum option is a selectable value for the custom field.

string

The color of the enum option. Defaults to ‘none’.

number | null

Conditional. This number is the value of a number custom field.

string | null

Conditional. This string is the value of a text custom field.

string | null

A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.

boolean

True if the project is currently marked complete, false if not.

date-time | null

The time at which this project was completed, or null if the project is not completed.

object | null

The user that marked this project complete, or null if the project is not completed.

array of objects

Array of users following this project. Followers are a subset of members who have opted in to receive "tasks added" notifications for a project.

followers
object
string

Globally unique identifier of the resource, as a string.

string

The base type of this resource.

string

Read-only except when same user as requester. The user’s name.

object | null

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

object

The team that this project is shared with.

string | null

The icon for a project.

list board timeline calendar rocket people graph star bug light_bulb globe gear notebook computer check target html megaphone chat_bubbles briefcase page_layout mountain_flag puzzle presentation line_and_symbols speed_dial ribbon shoe shopping_basket map ticket coins

string
object | null

Opt In. The project brief associated with this project.

object | null

Opt In. The project template from which this project was created. If the project was not created from a template, this field will be null.

object

Create-only. The workspace or organization this project is associated with. Once created, projects cannot be moved to a different workspace. This attribute can only be specified at creation time. If the workspace for your project is an organization, you must also supply a team in the request body.

Language
Credentials
OAuth2
Request
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.