# Pinterest

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

## Connect Pinterest

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose Pinterest.** 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 |
| --- | --- | --- | --- |
| **Number of concurrent workers** | integer | No | The number of worker threads to use for the sync. Higher values can speed up syncs but may increase rate-limit pressure against Pinterest. Default `2`. |
| **Account ID** | string | No | The Pinterest account ID you want to fetch data for. This ID must be provided to filter the data for a specific account. |
| **OAuth2.0** | object | No |  |
| **Custom Reports** | array | No | A list which contains ad statistics entries, each entry must have a name and can contains fields, breakdowns or action_breakdowns. |
| **Start Date** | string | No | A date in the format YYYY-MM-DD. If you have not set a date, it would be defaulted to latest allowed date by api (89 days from today). |
| **Status** | array | No | For the ads, ad_groups, and campaigns streams, specifying a status will filter out records that do not match the specified ones. If a status is not specified, the source will default to records with a status of either ACTIVE or PAUSED. |

## 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.
:::