Create a section in a project

Creates a new section in a project.
Returns the full record of the newly created section.

curl --location --request POST 'https://app.asana.com/api/1.0/projects//sections' \ --header 'Content-Type: application/json' \ --data-raw '{ "data": { "insert_after": "987654", "insert_before": "86420", "name": "Next Actions", "project": "13579" } }'

{ "data": { "gid": "12345", "resource_type": "task", "name": "Next Actions", "created_at": "2012-02-22T02:06:58.147Z", "project": { "gid": "12345", "resource_type": "task", "name": "Stuff to buy" }, "projects": [ { "gid": "12345", "resource_type": "task", "name": "Stuff to buy" } ] } }

Request

Path Params

project_gid

string

required

Body Params application/json

data

object (SectionRequest)

optional

insert_after

string

optional

An existing section within this project after which the added section should be inserted. Cannot be provided together with insert_before.

Example:

987654

insert_before

string

optional

An existing section within this project before which the added section should be inserted. Cannot be provided together with insert_after.

Example:

86420

name

string

required

The text to be displayed as the section name. This cannot be an empty string.

Example:

Next Actions

project

string

required

Create-Only The project to create the section in

Example:

13579

Examples

Responses

🟢201Successfully created the specified section.

application/json

Body

data

object (SectionResponse)

optional

A section is a subdivision of a project that groups tasks together. It can either be a header above a list of tasks in a list view or a column in a board view of a project.

created_at

string <date-time>

read-onlyoptional

The time at which this resource was created.

Example:

2012-02-22T02:06:58.147Z

project

object

ProjectCompact

optional

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.

projects

array[object (ProjectCompact) {3}]

read-onlyoptional

Deprecated - please use project instead

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

name

string

optional

The name of the section (i.e. the text displayed as the section header).

Example:

Next Actions

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500