triggers_create
Create a Google Tag Manager trigger with specified type, filters, and parameters to control when tags fire. Requires write access and confirmation.
Instructions
[WRITE] Create a GTM trigger. Requires GTM_MCP_ENABLE_WRITES=true and confirm=true.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Trigger name. | |
| type | Yes | Trigger type (e.g. "click", "pageview", "customEvent", "domReady", "windowLoaded", "historyChange", "jsError", "scrollDepth", "elementVisibility", "timer", "youTubeVideo", "formSubmission", "linkClick"). | |
| limit | No | Timer trigger: max number of times the timer fires, as a single Parameter {type:"template", value:"3"} (no key). Dedicated TOP-LEVEL GTM field — do NOT put it in `parameter`. | |
| notes | No | ||
| filter | No | Conditions that must be met for the trigger to fire ("fires on SOME …"). | |
| confirm | Yes | ||
| interval | No | Timer trigger: firing interval in MILLISECONDS as a single Parameter {type:"template", value:"5000"} (no key). This is a dedicated TOP-LEVEL GTM field — do NOT put it in `parameter`. | |
| accountId | Yes | ||
| eventName | No | Custom event name (for customEvent type). | |
| parameter | No | Trigger settings as a parameter list — e.g. a YouTube Video trigger's captureStart/progressThresholdsPercent, scroll thresholds, element-visibility selector. NOTE: a timer's interval/limit are the separate top-level `interval`/`limit` fields, NOT here. | |
| containerId | Yes | ||
| waitForTags | No | Form/link trigger: send a plain boolean (true/false). A Parameter {type:"boolean", value:"true"} is also accepted. | |
| workspaceId | Yes | ||
| parentFolderId | No | ||
| autoEventFilter | No | Conditions for auto-event triggers (legacy; most scopes use `filter`). | |
| checkValidation | No | Form/link trigger: send a plain boolean (true/false). A Parameter object is also accepted. | |
| intervalSeconds | No | Timer trigger: firing interval in SECONDS as a single Parameter (no key). Top-level GTM field. Use interval (ms) OR intervalSeconds, not both. | |
| customEventFilter | No | Used for custom event triggers. | |
| waitForTagsTimeout | No | Form/link trigger: timeout in milliseconds. Send a plain number (e.g. 2000). A Parameter object is also accepted. |