update_reddit_channel_settings
Update the Reddit channel settings of an existing DRAFT wizard campaign: native objective, allow comments, placements (feed/conversations), conversion pixel, and (for manual-bid…
Destructive campaigns
Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.
What it does
Update the Reddit channel settings of an existing DRAFT wizard campaign: native objective, allow comments, placements (feed/conversations), conversion pixel, and (for manual-bid objectives) the bid amount.
These are the same settings the platform UI shows in the Reddit section of the
campaign draft page. The campaign MUST already have its Reddit channel enabled
(via create_campaign / add_and_edit_campaign_elements with a `reddit` block).
⚠️ DRAFT-ONLY: the platform rejects these edits once the campaign is Launching/Launched.
KEYWORDS: reddit, reddit campaign, reddit settings, campaign settings, draft campaign,
objective, native objective, traffic, brand awareness, reach, views, video views, video views 6s,
impressions, clicks, comments, allow comments, placements, placement, feed, conversations,
pixel, conversion pixel, conversion tracking, bid, bid amount, manual bid, auto bid, settings
WHEN TO USE:
- Change the Reddit objective (e.g. from Brand Awareness to Traffic)
- Toggle "Allow comments" on Reddit ads
- Select placements (Feed and/or Conversations)
- Attach or clear a Reddit conversion pixel
- Set a manual bid amount for Brand Awareness / Video Views objectives
PARAMETERS (campaign_id required; everything else optional — unspecified
settings keep their current values on the channel):
- campaign_id: the wizard campaign ID
- objective: IMPRESSIONS (Brand awareness and Reach) | CLICKS (Traffic) |
VIDEO_VIEWABLE_IMPRESSIONS_6S (Video Views 6s). Mirrors the platform UI's
Native Objective dropdown.
⚠️ Lead Gen (CPL) campaigns only accept CLICKS (landing pages require it).
⚠️ Video Views requires the channel to contain ONLY video ads.
- allow_comments: whether Redditors can comment on the promoted post (platform default: true)
- placements: {"feed": bool, "conversations": bool}. At least one must stay
selected (Feed wins if both are false). Conversations is forced OFF when the
channel has video ads.
- conversion_pixel_id: pixel id from the account's Reddit Ads Manager. Pass an
empty string "" to clear. Pixels are managed in Reddit Ads Manager, not here.
- bid_amount: manual bid amount. Only applied when the effective objective uses
MANUAL_BID (IMPRESSIONS / Video Views). Ignored for CLICKS (AUTO_BID).
BID STRATEGY (automatic): changing the objective re-applies the UI's auto-switch —
CLICKS → AUTO_BID; IMPRESSIONS / VIDEO_VIEWABLE_IMPRESSIONS_6S → MANUAL_BID.
The bid strategy is left untouched when neither objective nor bid_amount is sent.
EXAMPLES:
Switch a Brand Awareness campaign's Reddit channel to Traffic:
update_reddit_channel_settings({"campaign_id": 12345, "objective": "CLICKS"})
Disable comments and run Feed-only:
update_reddit_channel_settings({
"campaign_id": 12345,
"allow_comments": false,
"placements": {"feed": true, "conversations": false}
})
Brand awareness with a manual bid and a conversion pixel:
update_reddit_channel_settings({
"campaign_id": 12345,
"objective": "IMPRESSIONS",
"bid_amount": 1.5,
"conversion_pixel_id": "pixel_abc123"
})
RESPONSE: {success, campaign_id, channel_id, campaign_status, applied:{...}, errors?}
`applied` echoes exactly what was pushed to the platform.
INTEGRATION WITH OTHER TOOLS:
- Use search_campaigns_by_names / get_campaign_by_wizard_id to find the campaign
- Reddit channel is enabled by create_campaign or add_and_edit_campaign_elements
- Reddit ads come from create_update_image_ad / create_update_video_ad with channels=["REDDIT"]Arguments
| Argument | Type | Notes | |
|---|---|---|---|
campaign_id |
integer | required | The unique identifier of the wizard campaign |
objective |
string | Reddit native objective. IMPRESSIONS = Brand awareness and Reach; CLICKS = Traffic (the only objective allowed on Lead Gen campaigns); VIDEO_VIEWABLE_IMPRESSIONS_6S = Video Views 6s (video-only channels). one of: IMPRESSIONS, CLICKS, VIDEO_VIEWABLE_IMPRESSIONS_6S |
|
allow_comments |
boolean | Allow Redditors to comment on the promoted post. Platform default is true. | |
placements |
object | Where the ads serve. At least one placement must stay selected; conversations is forced off when the channel has video ads. | |
conversion_pixel_id |
string | Reddit conversion pixel id (created in Reddit Ads Manager). Empty string clears the pixel. | |
bid_amount |
number | Manual bid amount, applied only when the effective objective uses MANUAL_BID (IMPRESSIONS / Video Views). |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_reddit_channel_settings","arguments":{"campaign_id":0}}}'
Response
No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other campaigns tools: