# Reddit Ads

Source: https://pilot.braike.com/en/docs/regies/reddit-ads

The 18 tools Pilot MCP serves for Reddit Ads: 5 read-only, and 13 that write with the €29 plan, taken from the server.

Pilot MCP serves **5 read-only tools** for Reddit Ads, on every plan. With the €29 plan, it also serves **10** that create or change and **3** that delete. Their names start with `reddit_ads_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 5 |
| [Create and change (€29)](#modification) | 10 |
| [Delete (€29)](#suppression) | 3 |

## Other tools [#autres]

### `reddit_ads_get_ad_account` [#reddit_ads_get_ad_account]

**Reddit Ads: Get Ad Account** · read-only · idempotent

The Reddit Ads ad account linked to the workspace: name, currency, time zone of the days, status at Reddit (VALID, PENDING, SUSPENDED…) and suspension reason, account type, click-through and view-through conversion attribution windows. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_get_statistics` [#reddit_ads_get_statistics]

**Reddit Ads: Get Statistics** · read-only · idempotent

The Reddit Ads statistics of the linked account, by level (ACCOUNT, CAMPAIGN, AD\_GROUP, AD), per day (DAY) or over the whole period (TOTAL), days in the account time zone, 92 days at most: impressions, clicks, spend (units of the account currency), key conversions (click and view), value of attributed purchases, conversion breakdown by type (purchases, leads, sign-ups, add to cart, page views) by click and by view, video plays and quartiles, reach and frequency (not additive). CTR, CPC, CPM and cost per conversion recomputed. Conversions follow the account attribution windows. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `level` | `string` | yes | The level of the rows. Values: `"ACCOUNT"`, `"CAMPAIGN"`, `"AD_GROUP"`, `"AD"`. |
| `granularity` | `string` | no | DAY (default): one row per entity and per day; TOTAL: one row per entity over the period. Values: `"DAY"`, `"TOTAL"`. |
| `start_date` | `string` | yes | First day, YYYY-MM-DD, inclusive. |
| `end_date` | `string` | yes | Last day, YYYY-MM-DD, inclusive; at most 92 days after the first. |
| `metrics` | `string[]` | no | The metrics; when omitted, all of them. Values: `"IMPRESSIONS"`, `"CLICKS"`, `"SPEND"`, `"KEY_CONVERSION_TOTAL_COUNT"`, `"KEY_CONVERSION_CLICKS"`, `"KEY_CONVERSION_VIEWS"`, `"CONVERSION_PURCHASE_CLICKS"`, `"CONVERSION_PURCHASE_VIEWS"`, `"CONVERSION_PURCHASE_TOTAL_VALUE"`, `"CONVERSION_LEAD_CLICKS"`, `"CONVERSION_LEAD_VIEWS"`, `"CONVERSION_SIGN_UP_CLICKS"`, `"CONVERSION_SIGN_UP_VIEWS"`, `"CONVERSION_ADD_TO_CART_CLICKS"`, `"CONVERSION_ADD_TO_CART_VIEWS"`, `"CONVERSION_PAGE_VISIT_CLICKS"`, `"CONVERSION_PAGE_VISIT_VIEWS"`, `"VIDEO_STARTED"`, `"VIDEO_WATCHED_25_PERCENT"`, `"VIDEO_WATCHED_50_PERCENT"`, `"VIDEO_WATCHED_75_PERCENT"`, `"VIDEO_WATCHED_100_PERCENT"`, `"REACH"`, `"FREQUENCY"`. |
| `ids` | `string[]` | no | Read only these entities of the requested level (200 at most; not at the ACCOUNT level). |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_list_ad_groups` [#reddit_ads_list_ad_groups]

**Reddit Ads: List Ad Groups** · read-only · idempotent

The Reddit Ads ad groups of the linked account (the level that most often holds budget, bid, dates and targeting): configured and applied status, budget (amount in units of the account currency, DAILY\_SPEND or LIFETIME\_SPEND; absent under a campaign with a campaign budget), bid and its type (CPC, CPM, CPV), bid strategy, optimization goal, dates. Can be filtered by campaign. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | no | Read only the ad groups of this campaign. |
| `ad_group_ids` | `string[]` | no | Read only these ad groups (200 at most). |
| `max_items` | `integer` | no | Items to read (default 100, maximum 1000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_list_ads` [#reddit_ads_list_ads]

**Reddit Ads: List Ads** · read-only · idempotent

The Reddit Ads ads of the linked account: configured and applied status, rejection reason, destination URL, post that carries the ad and preview (temporary URL). Can be filtered by ad group, campaign and status. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | no | Read only the ads of this ad group. |
| `campaign_id` | `string` | no | Read only the ads of this campaign. |
| `configured_status` | `string` | no | Filter by configured status (ACTIVE, PAUSED, ARCHIVED). |
| `effective_status` | `any` | no | Filter by the status applied by Reddit (ACTIVE, REJECTED, PENDING\_APPROVAL…). |
| `max_items` | `integer` | no | Items to read (default 100, maximum 1000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_list_campaigns` [#reddit_ads_list_campaigns]

**Reddit Ads: List Campaigns** · read-only · idempotent

The Reddit Ads campaigns of the linked account: id, name, configured status (ACTIVE, PAUSED, ARCHIVED) and status applied by Reddit, objective, campaign budget when it is optimized at the campaign level (amount in units of the account currency, DAILY\_SPEND or LIFETIME\_SPEND), spend cap, dates. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_ids` | `string[]` | no | Read only these campaigns (200 at most). |
| `max_items` | `integer` | no | Items to read (default 100, maximum 1000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `reddit_ads_create_ad` [#reddit_ads_create_ad]

**Reddit Ads: Create Ad** · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads ad under an ad group of the account linked to the workspace, always PAUSED, from a Reddit post (post\_id) and a destination URL. The ad group is read first and refused if it belongs to another account. Delete it with delete\_ad.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | yes |   |
| `name` | `string` | yes | Ad name. |
| `post_id` | `string` | yes | Reddit post that carries the ad (t3\_...). |
| `click_url` | `string` | no | Destination URL. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_create_ad_group` [#reddit_ads_create_ad_group]

**Reddit Ads: Create Ad Group** · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads ad group under a campaign of the account linked to the workspace, always PAUSED (manual setup). The campaign is read first and refused if it belongs to another account. bid\_strategy: BIDLESS, MAXIMIZE\_VOLUME or TARGET\_CPX; bid\_type: CPC, CPM, CPV6 or CPV15. targeting is passed as is (Reddit v3 targeting object). Delete it with delete\_ad\_group.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `name` | `string` | yes | Ad group name. |
| `bid_strategy` | `string` | yes | Bid strategy. Values: `"BIDLESS"`, `"MAXIMIZE_VOLUME"`, `"TARGET_CPX"`. |
| `bid_type` | `string` | yes | Bid type. Values: `"CPC"`, `"CPM"`, `"CPV6"`, `"CPV15"`. |
| `bid_amount` | `number` | no | Required by Reddit for TARGET\_CPX. |
| `budget_amount` | `number` | no | The ad group budget, in units of the account currency (12.5 for 12.50). |
| `budget_type` | `string` | no | Required with budget\_amount. Values: `"DAILY_SPEND"`, `"LIFETIME_SPEND"`. |
| `start_time` | `string` | no | Start, ISO 8601. |
| `end_time` | `string` | no | End, ISO 8601. |
| `targeting` | `object` | no | Reddit v3 targeting object. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_create_campaign` [#reddit_ads_create_campaign]

**Reddit Ads: Create Campaign** · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads campaign in the account linked to the workspace, always PAUSED (manual setup). objective: APP\_INSTALLS, BRAND\_AWARENESS, CATALOG\_SALES, CLICKS, CONVERSIONS, IMPRESSIONS, LEAD\_GENERATION, SALES or VIDEO\_VIEWABLE\_IMPRESSIONS. A campaign budget (budget\_amount + budget\_type) makes it a campaign-budget campaign. Read back after creation. Delete it with delete\_campaign.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | yes | Campaign name. |
| `objective` | `string` | yes | Campaign objective. Values: `"APP_INSTALLS"`, `"BRAND_AWARENESS"`, `"CATALOG_SALES"`, `"CLICKS"`, `"CONVERSIONS"`, `"IMPRESSIONS"`, `"LEAD_GENERATION"`, `"SALES"`, `"VIDEO_VIEWABLE_IMPRESSIONS"`. |
| `budget_amount` | `number` | no | The campaign budget, in units of the account currency (12.5 for 12.50). |
| `budget_type` | `string` | no | Required with budget\_amount. Values: `"DAILY_SPEND"`, `"LIFETIME_SPEND"`. |
| `funding_instrument_id` | `string` | no | Funding instrument (payment method) of the account. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_ad_group_bid` [#reddit_ads_update_ad_group_bid]

**Reddit Ads: Update Ad Group Bid** · create or change, €29 plan · creates an object on each call

Changes the bid of a Reddit Ads ad group, in units of the account currency. Refused for an ad group with no bid to set (BIDLESS, MAXIMIZE\_VOLUME). Reads it back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | yes |   |
| `bid_amount` | `number` | yes | The bid, in units of the account currency (12.5 for 12.50). |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_ad_group_budget` [#reddit_ads_update_ad_group_budget]

**Reddit Ads: Update Ad Group Budget** · create or change, €29 plan · creates an object on each call

Changes the budget of a Reddit Ads ad group, in units of the account currency. Refused under a campaign with a campaign budget (change the campaign budget instead). Reads it back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | yes |   |
| `budget_amount` | `number` | yes | The budget, in units of the account currency (12.5 for 12.50). |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_ad_group_status` [#reddit_ads_update_ad_group_status]

**Reddit Ads: Update Ad Group Status** · create or change, €29 plan · creates an object on each call

Pauses (PAUSED) or reactivates (ACTIVE) an ad group of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | yes |   |
| `status` | `string` | yes | ACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_ad_status` [#reddit_ads_update_ad_status]

**Reddit Ads: Update Ad Status** · create or change, €29 plan · creates an object on each call

Pauses (PAUSED) or reactivates (ACTIVE) an ad of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | yes |   |
| `status` | `string` | yes | ACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_campaign_budget` [#reddit_ads_update_campaign_budget]

**Reddit Ads: Update Campaign Budget** · create or change, €29 plan · creates an object on each call

Changes the budget of a Reddit Ads campaign that has a campaign budget, in units of the account currency. Refused for a campaign without a campaign budget (the budget then lives on its ad groups). Reads it back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `budget_amount` | `number` | yes | The budget, in units of the account currency (12.5 for 12.50). |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_campaign_spend_cap` [#reddit_ads_update_campaign_spend_cap]

**Reddit Ads: Update Campaign Spend Cap** · create or change, €29 plan · creates an object on each call

Changes the lifetime spend cap of a Reddit Ads campaign, in units of the account currency. Reads it back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `spend_cap_amount` | `number` | yes | The spend cap, in units of the account currency (12.5 for 12.50). |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_update_campaign_status` [#reddit_ads_update_campaign_status]

**Reddit Ads: Update Campaign Status** · create or change, €29 plan · creates an object on each call

Pauses (PAUSED) or reactivates (ACTIVE) a campaign of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `status` | `string` | yes | ACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `reddit_ads_delete_ad` [#reddit_ads_delete_ad]

**Reddit Ads: Delete Ad** · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE ad of the Reddit Ads account linked to the workspace (configured\_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_delete_ad_group` [#reddit_ads_delete_ad_group]

**Reddit Ads: Delete Ad Group** · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE ad group of the Reddit Ads account linked to the workspace (configured\_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ad_group_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |

### `reddit_ads_delete_campaign` [#reddit_ads_delete_campaign]

**Reddit Ads: Delete Campaign** · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE campaign of the Reddit Ads account linked to the workspace (configured\_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one. |
