CDPGuidesSupport

Tag Manager Tags

Manage the tags that fire inside a tag manager. Tags reference one or more triggers — when a trigger matches, the tag's parameters are evaluated and the tag fires (with optional block triggers that suppress it).

Tags are the actions a tag manager performs — fire a Google Analytics event, drop a Meta pixel call, run a custom snippet, etc. Every tag belongs to exactly one tag manager and references trigger ids that decide when it fires. A tag fires when one of its fire triggers matches; block triggers suppress firing and are evaluated after fire triggers.

Browser interaction tracking uses a CustomEvent trigger and a Track tag whose fireTriggerIds includes the returned trigger ID. The Tag Manager guide documents the complete request sequence.

To move a tag into a folder, use POST /rest/v1/tag-manager-asset-folders — folderId is read-only on this endpoint. Tags cannot move between tag managers; omit tagManagerId on PATCH.

Discovering supported tag types

Call GET /rest/v1/tag-manager-tags/types to list the supported type values and the per-type parameters schema. Each field entry tells you whether the value is required, what validators apply, and (for fields with a fixed set of choices) the allowed availableValues. Sending an unknown type or a parameters payload that violates one of those constraints returns HTTP 400.

GET/rest/v1/tag-manager-tags

GET
/rest/v1/tag-manager-tags

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Query Parameters

limit?|

Maximum number of tags to return. Defaults to 25; values below 1 are clamped to 1 and values above 1000 are clamped to 1000. The web-app passes 1000 to render the full workspace in one request.

cursor?string

Opaque pagination cursor from pagination.nextCursor in the previous response. Do not decode or modify it. Malformed cursors return 400 Bad Request.

tagManagerId*string

Parent tag manager whose tags should be returned.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/rest/v1/tag-manager-tags?tagManagerId=string"
{  "entities": [    {      "id": "string",      "tagManagerId": "string",      "accountId": "string",      "name": "string",      "type": "string",      "parameters": {},      "fireTriggerIds": [        "string"      ],      "blockTriggerIds": [        "string"      ],      "priority": 0,      "enabled": true,      "folderId": "string",      "createdAt": "string",      "updatedAt": "string"    }  ],  "pagination": {    "nextCursor": "string",    "hasMore": true  }}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

POST/rest/v1/tag-manager-tags

POST
/rest/v1/tag-manager-tags
*object
object
array<string>

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/rest/v1/tag-manager-tags" \  -H "Content-Type: application/json" \  -d '{    "tagManagerId": "string",    "name": "string",    "type": "string",    "parameters": {},    "fireTriggerIds": [      "string"    ]  }'
{  "id": "string",  "tagManagerId": "string",  "accountId": "string",  "name": "string",  "type": "string",  "parameters": {},  "fireTriggerIds": [    "string"  ],  "blockTriggerIds": [    "string"  ],  "priority": 0,  "enabled": true,  "folderId": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

GET/rest/v1/tag-manager-tags/{id}

GET
/rest/v1/tag-manager-tags/{id}

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/rest/v1/tag-manager-tags/string"
{  "id": "string",  "tagManagerId": "string",  "accountId": "string",  "name": "string",  "type": "string",  "parameters": {},  "fireTriggerIds": [    "string"  ],  "blockTriggerIds": [    "string"  ],  "priority": 0,  "enabled": true,  "folderId": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

PATCH/rest/v1/tag-manager-tags/{id}

PATCH
/rest/v1/tag-manager-tags/{id}
*object
object
array<string>

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/rest/v1/tag-manager-tags/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "string",  "tagManagerId": "string",  "accountId": "string",  "name": "string",  "type": "string",  "parameters": {},  "fireTriggerIds": [    "string"  ],  "blockTriggerIds": [    "string"  ],  "priority": 0,  "enabled": true,  "folderId": "string",  "createdAt": "string",  "updatedAt": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

DELETE/rest/v1/tag-manager-tags/{id}

DELETE
/rest/v1/tag-manager-tags/{id}

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/rest/v1/tag-manager-tags/string"
{  "id": "string",  "deleted": true}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

GET/rest/v1/tag-manager-tags/types

GET
/rest/v1/tag-manager-tags/types

Authorization

apiKey
AuthorizationBearer <token>

Ours Privacy API key

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/rest/v1/tag-manager-tags/types"
{  "entities": [    {      "id": "string",      "name": "string",      "category": "string",      "description": "string",      "fields": [        {          "id": "string",          "type": "STRING",          "title": "string",          "description": "string",          "required": true,          "default": {},          "availableValues": [            {              "value": "string",              "label": "string"            }          ],          "allowedKeys": [            "string"          ],          "validators": [            {              "type": "NotEmpty",              "min": 0,              "max": 0            }          ]        }      ]    }  ]}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}
{  "error": "string",  "details": "string"}

How is this guide?

Tag Managers

Previous Page

Tag Manager Triggers

Next Page