# Snapchat Ads

> Connect Snapchat Ads to sanda: what to prepare, the fields the connection form asks for, and how its data lands in your warehouse.

## Connect Snapchat Ads

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose Snapchat Ads.** It is listed under marketing and analytics; you can also search for it by name.
3. **Fill in the form.** Enter the fields below. Credentials go straight to sanda’s sync engine and are never stored in sanda’s database.
4. **Choose what to sync.** Pick the tables you want, and a sync mode for each. See [choose what to sync](https://docs.sanda-os.com.au/connections/choose-tables).
5. **Run the first sync.** sanda tests the connection, then lands each table you chose in your warehouse.
:::

## Configuration fields

What the connection form asks for. Required fields are marked; the rest are optional.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Client ID** | string, secret | Yes | The Client ID of your Snapchat developer application. |
| **Client Secret** | string, secret | Yes | The Client Secret of your Snapchat developer application. |
| **Refresh Token** | string, secret | Yes | Refresh Token to renew the expired Access Token. |
| **Start Date** | string | No | Date in the format 2022-01-01. Any data before this date will not be replicated. Default `2022-01-01`. |
| **End Date** | string | No | Date in the format 2017-01-25. Any data after this date will not be replicated. |
| **Action Report Time** | string | No | Specifies the principle for conversion reporting. One of `conversion`, `impression`. Default `conversion`. |
| **Swipe Up Attribution Window** | string | No | Attribution window for swipe ups. One of `1_DAY`, `7_DAY`, `28_DAY`. Default `28_DAY`. |
| **View Attribution Window** | string | No | Attribution window for views. One of `none`, `1_HOUR`, `3_HOUR`, `6_HOUR`, `1_DAY`, `7_DAY`. Default `1_DAY`. |
| **Organization IDs** | array | No | The IDs of the organizations to retrieve. |
| **Ad Account IDs** | array | No | Ad Account IDs of the ad accounts to retrieve. |

## Related

:::links
- [Sync modes](https://docs.sanda-os.com.au/connections/sync-modes): How sanda reads each table on every run.
- [Sync schedules](https://docs.sanda-os.com.au/connections/schedules): How often a connection runs.
- [Allowlist sanda’s address](https://docs.sanda-os.com.au/connections/allowlist): For a system behind a firewall.
- [Troubleshoot connections](https://docs.sanda-os.com.au/connections/troubleshooting): What an error means and how to fix it.
:::