---
title: "set_campaign_utms. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/set_campaign_utms
description: "Set or clear the UTM tracking parameters of ONE channel on a wizard campaign, merging into what the channel already stores. Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# set_campaign_utms

Set or clear the UTM tracking parameters of ONE channel on a wizard campaign, merging into what the channel already stores.

Destructive [campaigns](https://metadata.io/developers/tools/#cat-campaigns)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `campaign_id` | integer | required | Wizard campaign id (the `id` from list_wizard_campaigns). |
| `channel` | string | required | The enabled channel whose UTM mapping to edit.one of: `LINKEDIN`, `FACEBOOK`, `INSTAGRAM`, `GOOGLE_ADS`, `MICROSOFT_ADS`, `REDDIT` |
| `utms` | object | required | UTM key to value, e.g. {"UTM_SOURCE": "Linkedin", "UTM_MEDIUM": "paid-social", "UTM_CAMPAIGN": "DG_Touch-3_TAG", "UTM_CONTENT": "AD_NAME"}. Empty string clears a key. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other campaigns tools:

- [add_and_edit_campaign_elements](https://metadata.io/developers/tools/add_and_edit_campaign_elements) Destructive
- [add_and_edit_native_campaign_elements](https://metadata.io/developers/tools/add_and_edit_native_campaign_elements) Destructive
- [archive_campaigns](https://metadata.io/developers/tools/archive_campaigns) Destructive
- [check_campaign_launch_readiness](https://metadata.io/developers/tools/check_campaign_launch_readiness) Read
- [connect_channel](https://metadata.io/developers/tools/connect_channel) Writes
- [create_budget_group](https://metadata.io/developers/tools/create_budget_group) Destructive
- [create_campaign](https://metadata.io/developers/tools/create_campaign) Writes
- [create_native_structure_campaign](https://metadata.io/developers/tools/create_native_structure_campaign) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)