Create a tag

Creates a new tag in a workspace or organization.

Every tag 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.

Returns the full record of the newly created tag.

curl --location --request POST 'https://app.asana.com/api/1.0/tags' \ --header 'Content-Type: application/json' \ --data-raw '{ "data": { "name": "Stuff to buy", "color": "light-green", "followers": [ "12345", "42563" ], "workspace": "12345" } }'

{ "data": { "gid": "12345", "resource_type": "task", "name": "Stuff to buy", "color": "light-green", "followers": [ { "gid": "12345", "resource_type": "task", "name": "Greg Sanchez" } ], "permalink_url": "https://app.asana.com/0/resource/123456789/list", "workspace": { "gid": "12345", "resource_type": "task", "name": "My Company Workspace" } } }

Request

Body Params application/json

data

object (TagRequest)

optional

A tag is a label that can be attached to any task in Asana. It exists in a single workspace or organization.

followers

array[string]

optional

An array of strings identifying users. These can either be the string "me", an email, or the gid of a user.

Example:

["12345","42563"]

workspace

string

optional

Gid of an object.

Example:

12345

color

enum<string>

optional

Color of the tag.

Allowed values:

dark-pinkdark-greendark-bluedark-reddark-tealdark-browndark-orangedark-purpledark-warm-graylight-pinklight-greenlight-bluelight-redlight-teallight-brownlight-orangelight-purplelight-warm-gray

Example:

light-green

name

string

optional

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

Example:

Stuff to buy

Examples

Responses

🟢201Successfully created the newly specified tag.

application/json

Body

data

object (TagResponse)

optional

A tag is a label that can be attached to any task in Asana. It exists in a single workspace or organization.

followers

array[object (UserCompact) {3}]

read-onlyoptional

Array of users following this tag.

permalink_url

string

read-onlyoptional

A url that points directly to the object within Asana.

Example:

https://app.asana.com/0/resource/123456789/list

workspace

object

WorkspaceCompact

optional

A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.

color

enum<string>

optional

Color of the tag.

Allowed values:

dark-pinkdark-greendark-bluedark-reddark-tealdark-browndark-orangedark-purpledark-warm-graylight-pinklight-greenlight-bluelight-redlight-teallight-brownlight-orangelight-purplelight-warm-gray

Example:

light-green

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

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

Example:

Stuff to buy

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500