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

# TikTok 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>client_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>
</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 <a href="#connected-user-set">↓</a></td>
</tr>
</tbody>
</table>

<a id="connected-user-set"></a>

#### `connected_user`

When `connected_user` is set:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>advertisers</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Advertisers</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>custom_reports</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Custom reports<br/><br/>One report per line. Format: name:report_level:aggregate:dimensions:metrics. Example: my_report:auction_basic_campaign:daily:campaign_id</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>


#### Example

```json
{
  "name": "TikTok Ads connection",
  "type": "tiktok_ads",
  "configuration": {
    "client_id": "your_client_id",
    "client_secret": "your_client_secret"
  }
}
```


## 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</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


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


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







## 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": 3
  }
}
```