# PayPal

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

## Connect PayPal

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose PayPal.** It is listed under finance and payments; 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 |
| --- | --- | --- | --- |
| **Client ID** | string, secret | Yes | The Client ID of your Paypal developer application. |
| **Client secret** | string, secret | Yes | The Client Secret of your Paypal developer application. |
| **Start Date** | string | Yes | Start Date for data extraction in ISO format. Date must be in range from 3 years till 12 hrs before present time. |
| **Dispute Start Date Range** | string | No | Start Date parameter for the list dispute endpoint in ISO format. This Start Date must be in range within 180 days before present time, and requires ONLY 3 miliseconds(mandatory). If you don't use this option, it defaults to a start date set 180 days in the past. |
| **End Date** | string | No | End Date for data extraction in ISO format. This can be help you select specific range of time, mainly for test purposes or data integrity tests. When this is not used, now_utc is used by the streams. This does not apply to Disputes and Product streams. |
| **Sandbox** | boolean | Yes | Determines whether to use the sandbox or production environment. Default `false`. |
| **Refresh token** | string, secret | No | The key to refresh the expired access token. |
| **Number of days per request** | integer | No | The number of days per request. Must be a number between 1 and 31. Default `7`. |

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