# LinkedIn Ads

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

## Connect LinkedIn Ads

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose LinkedIn 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 streams you want, and a sync mode for each. See [choose what to sync](https://docs.sanda-os.com.au/connections/choose-streams).
5. **Run the first sync.** sanda tests the connection, then lands each stream as a table in your warehouse.
:::

## Configuration fields

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Account IDs** | array | No | Specify the account IDs to pull data from, separated by a space. Leave this field empty if you want to pull the data from all accounts accessible by the authenticated user. |
| **Custom Ad Analytics Reports** | array | No |  |
| **Custom Ad Statistics Reports** | array | No |  |
| **Authentication** | one of 2 options | No |  |
| **Lookback Window** | integer | No | How far into the past to look for records. (in days). Default `0`. |
| **Number of Workers** | integer | No | The number of workers to use for the connector. This is used to limit the number of concurrent requests to the LinkedIn Ads API. If not set, the default is 3 workers. Default `3`. |
| **Start Date** | string | Yes | UTC date in the format YYYY-MM-DD. Any data before this date will not be replicated. |

### Authentication


Choose one of the following. Each asks for its own fields.

**OAuth2.0**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Client ID** | string, secret | Yes | The client ID of your developer application. |
| **Client Secret** | string, secret | Yes | The client secret of your developer application. |
| **Refresh Token** | string, secret | Yes | The key to refresh the expired access token. |

**Access Token**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Access Token** | string, secret | Yes | The access token generated for your developer application. |


## Related

:::links
- [Sync modes](https://docs.sanda-os.com.au/connections/sync-modes): How sanda reads each stream 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.
:::