# Google Tag Manager

> Manage the tags on your website or app: add and change tags, triggers and variables, make versions and publish them, and start workflows when a version is made or published or a tag is added or changed.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/google-tag-manager

## Actions

### Create container

Create a container for a website or app, with its own GTM-XXXXXXX id.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Name (`name`, text, required): The container's name.
- Platform (`usage_context`, text, required): Where the container's tags run. One of: `web`, `android`, `ios`.
- Website addresses (`domain_names`, list): The website addresses to note on the container, such as acme.com.
- Notes (`notes`, text): Notes kept with the container in Tag Manager.

**Outputs**

- `container` (object): A container: the set of tags one website or app loads
- `container_id` (text): The new container's id

**Example output**

```json
{
  "container": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "domain_names": [
      "acme.com"
    ],
    "name": "acme.com",
    "notes": "",
    "path": "accounts/6012345678/containers/12345678",
    "public_id": "GTM-ABC1234",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678",
    "usage_context": [
      "web"
    ]
  },
  "container_id": "12345678"
}
```

### Create tag

Add a tag to a workspace, such as a Custom HTML tag or a Google tag, with the triggers that fire it. It goes live once a version with it is published.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Name (`name`, text, required): The tag's name.
- Tag type (`tag_type`, text): Tag Manager's code for the tag type, such as html for Custom HTML. Leave blank for a Custom HTML tag when Custom HTML is filled in.
- Custom HTML (`html`, text): For a Custom HTML tag: the HTML and script to add to the page. With this filled in, the tag type can be left blank.
- Settings (`parameters`, object): The tag's settings. Its settings as keys and values, for example {"name": "ecommerce.value", "dataLayerVersion": 2}. Text, numbers, true/false, lists and maps are typed for Tag Manager by their value.
- Firing triggers (`firing_trigger_ids`, list): The triggers that fire the tag.
- Blocking triggers (`blocking_trigger_ids`, list): Triggers that stop the tag firing.
- Fires (`tag_firing_option`, text): How often the tag fires. Defaults to once per event. One of: `unlimited` (Every time it is triggered), `oncePerEvent` (Once per event), `oncePerLoad` (Once per page load).
- Status (`status`, text): Whether the tag is active or paused. Defaults to active. One of: `active`, `paused`.
- Start firing at (`schedule_start`, date and time): Only fire from this date and time.
- Stop firing at (`schedule_end`, date and time): Stop firing after this date and time.
- Notes (`notes`, text): Notes kept with the tag in Tag Manager.

**Outputs**

- `tag` (object): A tag
- `tag_id` (text): The new tag's id

**Example output**

```json
{
  "tag": {
    "account_id": "6012345678",
    "blocking_trigger_ids": [],
    "container_id": "12345678",
    "fingerprint": "1730880000123",
    "firing_trigger_ids": [
      "12"
    ],
    "name": "Checkout pixel",
    "notes": "",
    "parameters": [
      {
        "key": "html",
        "type": "template",
        "value": "<script>console.log('hi')</script>"
      }
    ],
    "path": "accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "paused": false,
    "schedule_end": "",
    "schedule_start": "",
    "tag_firing_option": "oncePerEvent",
    "tag_id": "25",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "type": "html",
    "workspace_id": "7"
  },
  "tag_id": "25"
}
```

### Create trigger

Add a trigger to a workspace, such as a page view on certain pages or a custom event.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Name (`name`, text, required): The trigger's name.
- Trigger type (`trigger_type`, text, required): What the trigger listens for. One of: `pageview` (Page view), `domReady` (DOM ready), `windowLoaded` (Window loaded), `customEvent` (Custom event), `click` (Click: all elements), `linkClick` (Click: just links), `formSubmission` (Form submission), `scrollDepth` (Scroll depth), `elementVisibility` (Element visibility), `youTubeVideo` (YouTube video), and 24 more.
- Fire only when (`conditions`, list): Conditions that must all be true for the trigger to fire. Rows of variable, operator and value, such as [{"variable": "Page URL", "operator": "contains", "value": "/checkout"}]. Operators: equals, contains, startsWith, endsWith, matchRegex, greater, greaterOrEquals, less, lessOrEquals, cssSelector, urlMatches. Add "negate": true for "does not", and "ignore_case": true for a RegEx that ignores case.
- Event to match (`event_conditions`, list): For a custom event trigger: which event it listens for, such as [{"variable": "_event", "operator": "equals", "value": "purchase"}].
- Notes (`notes`, text): Notes kept with the trigger in Tag Manager.

**Outputs**

- `trigger` (object): A trigger
- `trigger_id` (text): The new trigger's id

**Example output**

```json
{
  "trigger": {
    "account_id": "6012345678",
    "conditions": [
      {
        "parameter": [
          {
            "key": "arg0",
            "type": "template",
            "value": "{{Page URL}}"
          },
          {
            "key": "arg1",
            "type": "template",
            "value": "/checkout"
          }
        ],
        "type": "contains"
      }
    ],
    "container_id": "12345678",
    "event_conditions": [],
    "fingerprint": "1730880000123",
    "name": "Checkout pages",
    "notes": "",
    "path": "accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
    "trigger_id": "12",
    "type": "pageview",
    "workspace_id": "7"
  },
  "trigger_id": "12"
}
```

### Create variable

Add a variable to a workspace, such as a Data Layer Variable tags can read.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Name (`name`, text, required): The variable's name.
- Variable type (`variable_type`, text, required): Tag Manager's code for the variable type, such as v for a Data Layer Variable.
- Settings (`parameters`, object): The variable's settings. Its settings as keys and values, for example {"name": "ecommerce.value", "dataLayerVersion": 2}. Text, numbers, true/false, lists and maps are typed for Tag Manager by their value.
- Notes (`notes`, text): Notes kept with the variable in Tag Manager.

**Outputs**

- `variable` (object): A variable
- `variable_id` (text): The new variable's id

**Example output**

```json
{
  "variable": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "fingerprint": "1730880000123",
    "name": "Order value",
    "notes": "",
    "parameters": [
      {
        "key": "name",
        "type": "template",
        "value": "ecommerce.value"
      },
      {
        "key": "dataLayerVersion",
        "type": "integer",
        "value": "2"
      }
    ],
    "path": "accounts/6012345678/containers/12345678/workspaces/7/variables/31",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/variables/31",
    "type": "v",
    "variable_id": "31",
    "workspace_id": "7"
  },
  "variable_id": "31"
}
```

### Create version

Make a version of the container from a workspace's changes, ready to publish. It doesn't publish: use 'Publish version' for that. The workspace is used up, as when you click Submit in Tag Manager.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Version name (`version_name`, text): A name for the version, such as what it changes.
- Notes (`notes`, text): Notes kept with the version in Tag Manager.

**Outputs**

- `new_workspace_path` (text): The workspace Tag Manager made in its place, if it made one
- `version` (object): A container version
- `version_id` (text): The new version's number

**Example output**

```json
{
  "new_workspace_path": "accounts/6012345678/containers/12345678/workspaces/8",
  "version": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "deleted": false,
    "description": "Adds the checkout pixel.",
    "fingerprint": "1730880000999",
    "name": "Checkout pixel",
    "path": "accounts/6012345678/containers/12345678/versions/14",
    "tag_count": 9,
    "tag_manager_url": "https://tagmanager.google.com/#/versions/accounts/6012345678/containers/12345678/versions/14",
    "tag_names": [
      "Checkout pixel",
      "Google tag"
    ],
    "trigger_count": 6,
    "variable_count": 11,
    "version_id": "14"
  },
  "version_id": "14"
}
```

### Create workspace

Create a workspace in a container, to make changes in without touching other drafts.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Name (`name`, text, required): The workspace's name.
- Description (`description`, text): What the workspace is for.

**Outputs**

- `workspace` (object): A workspace: a draft of changes to a container
- `workspace_id` (text): The new workspace's id

**Example output**

```json
{
  "workspace": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "description": "",
    "fingerprint": "1730880000000",
    "name": "Checkout changes",
    "path": "accounts/6012345678/containers/12345678/workspaces/7",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7",
    "workspace_id": "7"
  },
  "workspace_id": "7"
}
```

### Delete container

Delete a container with all its workspaces, tags and versions. Any website still loading it stops getting its tags.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.

**Outputs**

- `container_id` (text): The container deleted
- `deleted` (true/false): True once it is deleted

**Example output**

```json
{
  "container_id": "12345678",
  "deleted": true
}
```

### Delete tag

Delete a tag from a workspace.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Tag (`tag_id`, text, required): The tag in that workspace. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `tag_id` (text): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": "25"
}
```

### Get live version

Get the version that is published now: what websites using the container load.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.

**Outputs**

- `version` (object): A container version

**Example output**

```json
{
  "version": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "deleted": false,
    "description": "Adds the checkout pixel.",
    "fingerprint": "1730880000999",
    "name": "Checkout pixel",
    "path": "accounts/6012345678/containers/12345678/versions/14",
    "tag_count": 9,
    "tag_manager_url": "https://tagmanager.google.com/#/versions/accounts/6012345678/containers/12345678/versions/14",
    "tag_names": [
      "Checkout pixel",
      "Google tag"
    ],
    "trigger_count": 6,
    "variable_count": 11,
    "version_id": "14"
  }
}
```

### Get tag

Get one tag: its type, settings, triggers and schedule.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Tag (`tag_id`, text, required): The tag in that workspace. Pick one, or give its id from an earlier step.

**Outputs**

- `tag` (object): A tag

**Example output**

```json
{
  "tag": {
    "account_id": "6012345678",
    "blocking_trigger_ids": [],
    "container_id": "12345678",
    "fingerprint": "1730880000123",
    "firing_trigger_ids": [
      "12"
    ],
    "name": "Checkout pixel",
    "notes": "",
    "parameters": [
      {
        "key": "html",
        "type": "template",
        "value": "<script>console.log('hi')</script>"
      }
    ],
    "path": "accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "paused": false,
    "schedule_end": "",
    "schedule_start": "",
    "tag_firing_option": "oncePerEvent",
    "tag_id": "25",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "type": "html",
    "workspace_id": "7"
  }
}
```

### List accounts

List the Tag Manager accounts your Google account can open.

**Inputs**: None.

**Outputs**

- `accounts` (list): The accounts
- `count` (number): How many there are

**Example output**

```json
{
  "accounts": [
    {
      "account_id": "6012345678",
      "name": "Acme",
      "path": "accounts/6012345678",
      "tag_manager_url": "https://tagmanager.google.com/#/admin/accounts/6012345678"
    }
  ],
  "count": 1
}
```

### List containers

List the containers in an account: one for each website or app.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.

**Outputs**

- `containers` (list): The containers
- `count` (number): How many there are

**Example output**

```json
{
  "containers": [
    {
      "account_id": "6012345678",
      "container_id": "12345678",
      "domain_names": [
        "acme.com"
      ],
      "name": "acme.com",
      "notes": "",
      "path": "accounts/6012345678/containers/12345678",
      "public_id": "GTM-ABC1234",
      "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678",
      "usage_context": [
        "web"
      ]
    }
  ],
  "count": 1
}
```

### List tags

List the tags in a workspace, with their settings and triggers.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.

**Outputs**

- `count` (number): How many there are
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "account_id": "6012345678",
      "blocking_trigger_ids": [],
      "container_id": "12345678",
      "fingerprint": "1730880000123",
      "firing_trigger_ids": [
        "12"
      ],
      "name": "Checkout pixel",
      "notes": "",
      "parameters": [
        {
          "key": "html",
          "type": "template",
          "value": "<script>console.log('hi')</script>"
        }
      ],
      "path": "accounts/6012345678/containers/12345678/workspaces/7/tags/25",
      "paused": false,
      "schedule_end": "",
      "schedule_start": "",
      "tag_firing_option": "oncePerEvent",
      "tag_id": "25",
      "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/tags/25",
      "type": "html",
      "workspace_id": "7"
    }
  ]
}
```

### List triggers

List the triggers in a workspace: the rules that decide when tags fire.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.

**Outputs**

- `count` (number): How many there are
- `triggers` (list): The triggers

**Example output**

```json
{
  "count": 1,
  "triggers": [
    {
      "account_id": "6012345678",
      "conditions": [
        {
          "parameter": [
            {
              "key": "arg0",
              "type": "template",
              "value": "{{Page URL}}"
            },
            {
              "key": "arg1",
              "type": "template",
              "value": "/checkout"
            }
          ],
          "type": "contains"
        }
      ],
      "container_id": "12345678",
      "event_conditions": [],
      "fingerprint": "1730880000123",
      "name": "Checkout pages",
      "notes": "",
      "path": "accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
      "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
      "trigger_id": "12",
      "type": "pageview",
      "workspace_id": "7"
    }
  ]
}
```

### List variables

List the variables in a workspace, with their settings.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.

**Outputs**

- `count` (number): How many there are
- `variables` (list): The variables

**Example output**

```json
{
  "count": 1,
  "variables": [
    {
      "account_id": "6012345678",
      "container_id": "12345678",
      "fingerprint": "1730880000123",
      "name": "Order value",
      "notes": "",
      "parameters": [
        {
          "key": "name",
          "type": "template",
          "value": "ecommerce.value"
        },
        {
          "key": "dataLayerVersion",
          "type": "integer",
          "value": "2"
        }
      ],
      "path": "accounts/6012345678/containers/12345678/workspaces/7/variables/31",
      "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/variables/31",
      "type": "v",
      "variable_id": "31",
      "workspace_id": "7"
    }
  ]
}
```

### List versions

List a container's versions, newest last, with how many tags, triggers and variables each has.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Include deleted versions (`include_deleted`, true/false): Also list versions that were deleted.

**Outputs**

- `count` (number): How many there are
- `versions` (list): The versions

**Example output**

```json
{
  "count": 1,
  "versions": [
    {
      "account_id": "6012345678",
      "container_id": "12345678",
      "deleted": false,
      "name": "Checkout pixel",
      "path": "accounts/6012345678/containers/12345678/versions/14",
      "tag_count": 9,
      "trigger_count": 6,
      "variable_count": 11,
      "version_id": "14"
    }
  ]
}
```

### List workspaces

List a container's workspaces: the drafts changes are made in.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.

**Outputs**

- `count` (number): How many there are
- `workspaces` (list): The workspaces

**Example output**

```json
{
  "count": 1,
  "workspaces": [
    {
      "account_id": "6012345678",
      "container_id": "12345678",
      "description": "",
      "fingerprint": "1730880000000",
      "name": "Checkout changes",
      "path": "accounts/6012345678/containers/12345678/workspaces/7",
      "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7",
      "workspace_id": "7"
    }
  ]
}
```

### Publish version

Publish a version, so every website or app using the container gets it at once. Publishing an earlier version rolls back to it.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Version (`version_id`, text, required): The version to publish. Pick one, or give its number from 'Create version'.

**Outputs**

- `published` (true/false): True once it is published
- `version` (object): A container version

**Example output**

```json
{
  "published": true,
  "version": {
    "account_id": "6012345678",
    "container_id": "12345678",
    "deleted": false,
    "description": "Adds the checkout pixel.",
    "fingerprint": "1730880000999",
    "name": "Checkout pixel",
    "path": "accounts/6012345678/containers/12345678/versions/14",
    "tag_count": 9,
    "tag_manager_url": "https://tagmanager.google.com/#/versions/accounts/6012345678/containers/12345678/versions/14",
    "tag_names": [
      "Checkout pixel",
      "Google tag"
    ],
    "trigger_count": 6,
    "variable_count": 11,
    "version_id": "14"
  }
}
```

### Update tag

Change a tag: its name, settings, triggers, schedule or whether it is paused. Only the fields filled in change.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Tag (`tag_id`, text, required): The tag in that workspace. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name for the tag. Leave blank to keep it.
- Custom HTML (`html`, text): For a Custom HTML tag: the HTML and script to add to the page. Leave blank to keep it as it is.
- Settings (`parameters`, object): The tag's settings. Its settings as keys and values, for example {"name": "ecommerce.value", "dataLayerVersion": 2}. Text, numbers, true/false, lists and maps are typed for Tag Manager by their value. Only the keys given change; the others are kept.
- Firing triggers (`firing_trigger_ids`, list): The triggers that fire the tag. Replaces the current ones.
- Blocking triggers (`blocking_trigger_ids`, list): Triggers that stop the tag firing. Replaces the current ones.
- Fires (`tag_firing_option`, text): How often the tag fires. Leave blank to keep it as it is. One of: `unlimited` (Every time it is triggered), `oncePerEvent` (Once per event), `oncePerLoad` (Once per page load).
- Status (`status`, text): Whether the tag is active or paused. Leave blank to keep it as it is. One of: `active`, `paused`.
- Start firing at (`schedule_start`, date and time): Only fire from this date and time. Leave blank to keep it as it is.
- Stop firing at (`schedule_end`, date and time): Stop firing after this date and time. Leave blank to keep it as it is.
- Notes (`notes`, text): Notes kept with the tag in Tag Manager.

**Outputs**

- `tag` (object): A tag

**Example output**

```json
{
  "tag": {
    "account_id": "6012345678",
    "blocking_trigger_ids": [],
    "container_id": "12345678",
    "fingerprint": "1730880000123",
    "firing_trigger_ids": [
      "12"
    ],
    "name": "Checkout pixel",
    "notes": "",
    "parameters": [
      {
        "key": "html",
        "type": "template",
        "value": "<script>console.log('hi')</script>"
      }
    ],
    "path": "accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "paused": false,
    "schedule_end": "",
    "schedule_start": "",
    "tag_firing_option": "oncePerEvent",
    "tag_id": "25",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/tags/25",
    "type": "html",
    "workspace_id": "7"
  }
}
```

### Update trigger

Rename a trigger or change its conditions. Only the fields filled in change.

**Inputs**

- Account (`account_id`, text, required): The Tag Manager account. Pick one, or give its id.
- Container (`container_id`, text, required): The container in that account. Pick one, or give its id.
- Workspace (`workspace_id`, text, required): The workspace in that container: the draft the change goes into. Pick one, such as Default Workspace, or give its id.
- Trigger (`trigger_id`, text, required): The trigger in that workspace. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name for the trigger. Leave blank to keep it.
- Fire only when (`conditions`, list): Conditions that must all be true for the trigger to fire. Rows of variable, operator and value, such as [{"variable": "Page URL", "operator": "contains", "value": "/checkout"}]. Operators: equals, contains, startsWith, endsWith, matchRegex, greater, greaterOrEquals, less, lessOrEquals, cssSelector, urlMatches. Add "negate": true for "does not", and "ignore_case": true for a RegEx that ignores case. Replaces the current ones; leave blank to keep them.
- Event to match (`event_conditions`, list): For a custom event trigger: which event it listens for, such as [{"variable": "_event", "operator": "equals", "value": "purchase"}]. Replaces the current ones; leave blank to keep them.
- Notes (`notes`, text): Notes kept with the trigger in Tag Manager.

**Outputs**

- `trigger` (object): A trigger

**Example output**

```json
{
  "trigger": {
    "account_id": "6012345678",
    "conditions": [
      {
        "parameter": [
          {
            "key": "arg0",
            "type": "template",
            "value": "{{Page URL}}"
          },
          {
            "key": "arg1",
            "type": "template",
            "value": "/checkout"
          }
        ],
        "type": "contains"
      }
    ],
    "container_id": "12345678",
    "event_conditions": [],
    "fingerprint": "1730880000123",
    "name": "Checkout pages",
    "notes": "",
    "path": "accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
    "tag_manager_url": "https://tagmanager.google.com/#/container/accounts/6012345678/containers/12345678/workspaces/7/triggers/12",
    "trigger_id": "12",
    "type": "pageview",
    "workspace_id": "7"
  }
}
```
