# Typeform

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

## Connect Typeform

:::steps
1. **Open the catalogue.** In the console, go to **Data · Connections** and press **New connection**.
2. **Choose Typeform.** 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 |
| --- | --- | --- | --- |
| **Authorization Method** | one of 2 options | Yes |  |
| **Start Date** | string | No | The date from which you'd like to replicate data for Typeform API, in the format YYYY-MM-DDT00:00:00Z. All data generated after this date will be replicated. |
| **Form IDs to replicate** | array | No | When this parameter is set, the connector will replicate data only from the input forms. Otherwise, all forms in your Typeform account will be replicated. You can find form IDs in your form URLs. For example, in the URL "https://mysite.typeform.com/to/u6nXL7" the form_id is u6nXL7. You can find form URLs on Share panel. |

### Authorization Method


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

**OAuth2.0**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Access token** | string, secret | Yes | Access Token for making authenticated requests. |
| **Client id** | string, secret | Yes | The Client ID of the Typeform developer application. |
| **Client secret** | string, secret | Yes | The Client Secret the Typeform developer application. |
| **Refresh token** | string, secret | Yes | The key to refresh the expired access_token. |
| **Token expiry date** | string | Yes | The date-time when the access token should be refreshed. |

**Private Token**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| **Private Token** | string, secret | Yes | Log into your Typeform account and then generate a personal Access Token. |


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