Notion

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

Connect Notion

Open the catalogue. In the console, go to Data · Connections and press New connection.
Choose Notion. It is listed under product and operations; you can also search for it by name.
Fill in the form. Enter the fields below. Credentials go straight to sanda’s sync engine and are never stored in sanda’s database.
Choose what to sync. Pick the streams you want, and a sync mode for each. See choose what to sync.
Run the first sync. sanda tests the connection, then lands each stream as a table in your warehouse.

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

Field	Type	Required	Description
Authentication Method	one of 2 options	No	Choose either OAuth or Access Token.
Number of concurrent workers	integer	No	Number of worker threads to use for the sync. Higher values can speed up large syncs but may increase rate-limit pressure against Notion's limit of approximately three requests per second per integration. Default `3`.
Start Date	string	No	UTC date and time in the format YYYY-MM-DDTHH:MM:SS.000Z. During incremental sync, any data generated before this date will not be replicated. If left blank, the start date will be set to 2 years before the present date.

Choose either OAuth or Access Token.

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

OAuth2.0

Field	Type	Required	Description
Access Token	string, secret	Yes	The Access Token received by completing the OAuth flow for your Notion integration.
Client ID	string, secret	Yes	The Client ID of your Notion integration.
Client Secret	string, secret	Yes	The Client Secret of your Notion integration.

Access Token

Field	Type	Required	Description
Access Token	string, secret	Yes	The Access Token for your private Notion integration.

Something unclear or out of date? Tell us, and we will fix the page.