The notion connector reads the pages and databases shared with a Notion integration. It runs Airbyte's Notion connector definition inside the SDK.
| Connector name | notion |
| Products | Records |
| Credentials | The portal's Connect button, or an internal integration secret |
| Definition | Airbyte's source-notion manifest, version 4.0.28 (Elastic License 2.0) |
| Status | Preview: tested against Notion's documented responses, not yet on a live account |
What it pulls
| Object | Contents |
|---|---|
page |
Title and properties, parent, created and last edited times and people, archived flag, URL |
database |
Title, properties, parent, created and last edited times |
user |
Name, type, email for people |
comment |
Page, text, author, time. Off by default: one request per page. Add it with objects. |
Page body blocks are not pulled yet.
Credentials
- Go to notion.so/my-integrations and create an internal integration with Read content (and Read comments for comments).
- Copy the secret (
ntn_...). - Share each page or database with the integration: ••• on the page → Connections → your integration. Children of a shared page are shared too.
Or skip the tokens: click Connect next to Notion in the portal (Settings → Connected systems), then run datayield connect notion --broker.
Connect
datayield connect notion -o accessToken=env:NOTION_SECRETOptions
| Option | Required | Meaning |
|---|---|---|
accessToken |
yes | The integration secret. Stored as a secret. |
startDate |
no | Where the first run starts |
objects |
no | Any of page, database, user, comment |
New records on each run
Pages, databases and comments are read when their last edited time falls between the last successful run and now. Users are sent whole each run.