Add a custom field to a project

Custom fields are associated with projects by way of custom field settings. This method creates a setting for the project.

Path Params
string
required

Globally unique identifier for the 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

Information about the custom field setting.

object
Responses

Response body
object
object

Custom Fields Settings objects represent the many-to-many join of the Custom Field and Project as well as stores information that is relevant to that particular pairing.

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.

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.