Import from Notion

Notion databases are a common home for roadmaps, CRMs, content calendars, and operational trackers. Dotwave imports a Notion database as a flat dataset so you can chart it alongside the rest of your data. The one requirement people miss is that Notion never exposes a database to an integration until you explicitly connect them — so this article starts there.

Before you start — set up a Notion integration

1
Open your integrations page

Go to notion.so/my-integrations while signed in to the workspace that owns the data.

2
Create a new integration

Click New integration.

3
Name it and pick the workspace

Give it a clear name such as Dotwave and select the workspace whose databases you want to import.

4
Enable "Read content"

Under Capabilities, enable Read content. Dotwave only needs to read; it never writes back to Notion.

5
Submit and copy the token

Submit the integration, then copy the internal integration token. It starts with secret_ or ntn_. Treat it like a password.

6
Share each database with the integration

Open each Notion database you want to import, click ··· in the top-right, choose Add connections, and select your integration.

Warning

Skipping step 6 is the most common mistake. Dotwave won't see any databases until you explicitly share them with your integration.

Import a database

1
Add data source → Notion

From the Data sources page, click Add data source and choose Notion.

2
Paste your integration token

Paste the secret_ or ntn_ token you copied earlier.

3
Select the database

Dotwave lists every database the integration can see — that is, the ones you shared in step 6. Choose the one to import.

4
Import

Dotwave reads the rows and creates a dataset with one row per Notion page.

Property type mapping

Notion properties are richer than a flat table, so Dotwave maps each property type to a column type:

Limitations

A few Notion behaviors are worth knowing before you build on the imported data:

Note

An integration only sees databases explicitly shared with it, so you can keep the token scoped tightly. If you later need another database, repeat step 6 for that database — there is no need to create a new integration or token.

Was this helpful?

Didn't find what you need?

We reply to every message within 24 hours.

Contact us → Back to Dotwave