AdKit for Reddit Ads: Campaigns, Ad Groups, Ads and Reporting
Create, edit, and report on Reddit ads from an AI agent through the AdKit MCP connector: campaigns, ad groups, ads, carousels, account defaults, and results. Every change is saved as a draft that the user approves before it goes live. Use when the user wants to run, change, or check Reddit ads. Not for Reddit ad strategy or creative advice.
Reddit Ads with AdKit
This skill tells you how to create, edit, and report on Reddit ads through AdKit. It covers the steps, not the strategy.
Connect AdKit
AdKit is one MCP connector for Meta, Google, TikTok, LinkedIn, Microsoft, Reddit, X, and Pinterest ads.
- Claude, ChatGPT, and most AI apps: add a custom connector with the address
https://mcp.adkit.so, then sign in. - Claude Code:
claude mcp add --transport http adkit https://mcp.adkit.so
For other AI apps, see how to set up the AdKit MCP server for Reddit Ads. If the AdKit tools are not available, tell the user how to connect. Then stop.
What AdKit can do on Reddit
| Entity | Actions |
|---|---|
campaigns | list, get, create, update |
ad-groups | list, get, create, update |
ads | list, get, create, update (image, video, carousel, or an existing post) |
results | list (account, campaign, ad group, or ad level) |
accounts | list, available, connect, disconnect, update, profiles, pixels, funding-instruments |
drafts | get, publish (review your changes, then send them) |
AdKit cannot delete Reddit campaigns, ad groups, or ads. Pause them instead with status: "paused".
Steps
All calls go through adkit_manage with platform: "reddit". Before a call you have not made in this session, read its fields with adkit_help({ path: "manage reddit <entity> <action>" }). Do not guess field names. In this skill, campaigns create means entity: "campaigns", action: "create".
-
Project: call
adkit_projectsand get theprojectId. Every call needs it. -
Account: call
adkit_status. If no Reddit account is connected, calladkit_setupwithplatform: "reddit"and give the user the link. After they sign in, useaccountsavailable, thenaccountsconnect. -
Account defaults: find the profile, pixel, and funding instrument with
accountsprofiles,accountspixels, andaccountsfunding-instruments. Save them withaccountsupdate. This change applies immediately, with no draft. -
Build from the top down. Each create saves a draft. For each level, do these steps before you start the next level:
- Show the draft to the user (
draftsget, or the linkhttps://app.adkit.so/manage/drafts?open=<draftId>). - Wait for a yes. Then publish it with
draftspublish. - Use the Reddit ID that the publish result returns as the parent of the next level. A draft ID never works as a parent ID.
The levels, in order:
- Campaign:
campaignscreatewith a name and an objective. Campaigns start paused, so they spend nothing. - Ad group:
ad-groupscreatewith thecampaignId, the budget, bidding, and targeting. - Ad:
adscreatewith theadGroupIdand the creative. For an image or video: calladkit_managewithentity: "media"andaction: "request_upload_url"(no platform). It returns an upload URL. Send the file to that URL withPUT. Put the returneduploadIdincreative.media[].id. A video also needs a thumbnail image. AdKit sends the files to Reddit when the ad is published.
- Show the draft to the user (
-
Go live:
campaignsupdatewithstatus: "active". Publish that draft only after the user says yes. Then check withad-groupslistandadslistthat the ad groups and ads are active too. -
Results:
resultslistwith aleveland a date range (fromandto).
Reddit rules
- Write support is in beta. When a write fails, read the error and its
retryableflag. Check your drafts and the existing Reddit objects before you retry, so you do not create the same thing twice. Report unexpected failures withadkit_feedback. - Campaigns start paused. Ad groups and ads start active.
- A lifetime budget on the campaign turns on campaign budget optimization: Reddit splits that one budget across the ad groups. Otherwise, put a daily budget on each ad group.
- AdKit creates the Reddit post behind each ad. Do not create posts yourself.
- Use AdKit field names (camelCase). The entities in the table above ignore raw Reddit API field names.
Anything else in the Reddit API
For a Reddit feature that AdKit does not cover, use entity: "platform-api-request" with action: "mutate". The action is always mutate, also for reads. AdKit sends the request to https://ads-api.reddit.com/api/v3 as it is. The user must turn on Advanced Platform Access in AdKit's Agent Permissions.
- Check every path and field in the Reddit Ads API docs.
- Writes save a draft, like any other change.
- After you use it, report the missing feature with
adkit_feedback.
{
"projectId": "<projectId>",
"entity": "platform-api-request",
"action": "mutate",
"data": {
"platform": "reddit",
"accountId": "<accountId>",
"endpoint": "ad_accounts/<accountId>/campaigns",
"method": "GET",
"description": "List campaigns"
}
}
Other platforms
The same AdKit connector runs Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, X Ads, and Pinterest Ads ads. Each platform has its own skill in this repo, for example meta-ads and google-ads.
Related skills
- Downloads
- 1.4kAll time
- Security audit
- Review
- Last updated
- 1w ago
- Current version
- v2.0.1
- License
- MIT-0
