List Tags

get https://{subdomain}.myclickfunnels.com/api/v2/workspaces/{workspace_id}/contacts/tags

List all Contact Tags for your workspace

Path Params

workspace_id

integer

required

Query Params

after

string

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

sort_order

string

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

sort_property

string

Sort property of a list response. The default is id and thus the created_at order.
If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

filter

object

Filter by available properties in query params, like this: api/v2/resources?filter[id]=value&filter[another_property]=value1,value2. Check our Filtering guide for examples and all about filtering here.

Responses

Language

Credentials

Bearer

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://myworkspace.myclickfunnels.com/api/v2/workspaces/workspace_id/contacts/tags \
3
     --header 'accept: application/json'


xxxxxxxxxx
20
 
1
[
2
  {
3
    "id": 62,
4
    "public_id": "RIfSnl",
5
    "workspace_id": 42000,
6
    "name": "Example Tag",
7
    "color": "#d3647f",
8
    "created_at": "2025-03-05T12:39:45.340Z",
9
    "updated_at": "2025-03-05T12:39:45.340Z"
10
  },
11
  {
12
    "id": 63,
13
    "public_id": "zngmxH",
14
    "workspace_id": 42000,
15
    "name": "Example Tag",
16
    "color": "#413be0",
17
    "created_at": "2025-03-05T12:39:45.343Z",
18
    "updated_at": "2025-03-05T12:39:45.343Z"
19
  }
20
]

Pagination-Next	ID of the last item in the current response after which more records exist. You can use it in an `after` query parameter for cursor-based pagination to get to the next page.
Link	A direct link to the next page for the cursor-based pagination. It includes the `after` and the Pagination-Next ID value.

200OK

401Unauthorized

404Not Found