Create Tag

Create a tag

POST/api/tags

Use it in a workflow

Add a step and choose the Gorgias connector.
Pick the Create Tag action (under Tags).
Fill in the fields below, then reference the result from later steps as {{createTag.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

decorationobject

Information related to the style of the tag.

colorstringrequired

The color of the tag (Hex color code).

descriptionstring

Short description of the tag.

namestringrequired

Name of the tag. Tags' names are case sensitive.

json

{
  "name": "urgent",
  "decoration": {
    "color": "#F58D86"
  },
  "description": "Mark a ticket as urgent"
}

Response

Returns 201 with an object. Read it in later steps with {{createTag.response.data.<field>}}.

idinteger

ID of the tag.

decorationobject

colorstring

The color of the tag (Hex color code).

descriptionstring

Short description of the tag.

namestring

Name of the tag. Tags' names are case sensitive.

usageinteger

Number of tickets this tag is associated with.

uristring

URI of the tag

created_datetimestring (date-time)

When the tag was created.

deleted_datetimestring (date-time)

When the tag was deleted.

json

{
  "id": 0,
  "decoration": {
    "color": "string"
  },
  "description": "string",
  "name": "string",
  "usage": 0,
  "uri": "string",
  "created_datetime": "2025-01-01T00:00:00Z",
  "deleted_datetime": "2025-01-01T00:00:00Z"
}

Need more? See the Gorgias guide for connection setup and behaviour shared by every action.

Was this page helpful?