> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Reddit Ads

Supports:
* ✅ Models
* ✅ Model sync destination
* ✅ Bulk sync source
* ✅ Connection Proxy


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>accounts</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Accounts</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>application_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>oauth_refresh_token</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>pixel_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Conversion pixel ID<br/><br/>Required if syncing conversion events to Reddit Ads.</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Read-only property</th><th>Type</th><th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>connected_user</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected user's email</td>
</tr>
</tbody>
</table>


#### Example

```json
{
  "name": "Reddit Ads connection",
  "type": "redditads",
  "configuration": {
    "accounts": [
        {
            "label": "",
            "value": ""
        }
    ],
    "application_id": "a45gadsfdsaf47byor2ugfbhsgllpf12gf56gfds",
    "client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "oauth_refresh_token": "dasfdasz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "pixel_id": ""
  }
}
```


## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>object</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object<br/><br/>Accepted values: `ad_account_history`, `ad_group`, `ad`, `campaign`, `custom_audience`, `lead_gen_form`, `profile`, `carrier`, `community`, `geolocation`, `device`, `time_zone`, `conversions`</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "object": "people"
  }
}
```


### Target
Reddit Ads connections may be used as the destination in a model sync.




### Target creation

Reddit Ads connections may be used to create a new target for a model sync. The
following parameters are required to create a new target:

<table>
<thead>
<tr>
  <th>NAME</th>
  <th>DESCRIPTION</th>
  <th>ENUM</th>
</tr></thead>
<tbody>
<tr>
  <td>account</td>
  <td>Reddit Ads account ID</td>
  <td>true</td>
</tr>

<tr>
  <td>name</td>
  <td>Audience name</td>
  <td>false</td>
</tr>

</tbody>
</table>




## Bulk Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>reporting_lookback</code></td>
<td><code>integer</code></td>
<td style="vertical-align: top;">Lookback period for reports</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "source_configuration": {
    "reporting_lookback": 37
  }
}
```