/api/v1/notion/importImport from Notion (connected)
Imports pages (up to 50 Notion page or database ids; everything under them comes too) into destination (as for an export: workspace, team, folder, new_folder, folder_name; omit workspace for My files) and returns the import (source: api), followed like any Notion import. exclude: ids under those pages to leave out (sub-pages, databases or database rows, with everything under them); a sync never brings them back, but pages and rows added in Notion later still come. keep_in_sync: bring Notion's changes over about every 15 minutes, one way. Imported items get the destination's default access, never public; you must be able to add pages there.
Guide: Import from Notion
Code samples and Try itRequest body
#application/json, required
connection_idstringDefault: your only Notion connection. Matches
^[A-Za-z0-9_-]{4,64}$.pagesarray of objectRequiredThe pages / databases to import (their sub-pages come with them). 1–50 items.
3 fields inside
idstringRequiredA Notion page or database id. 32–36 characters.
kindstringOne of
page,database. One ofpage,database.titlestringShown on the page and in link previews. Up to 200 characters.
destinationobject5 fields inside
workspacestringFile it in this workspace: the workspace's id. Up to 64 characters.
teamstringA team's id, slug or name; empty: company-wide. Up to 100 characters.
folderstringAn existing folder of
workspace: its id or its path, likeguides/setup. Up to 500 characters.new_folderbooleanPut everything in a new folder (My files: a page) named folder_name. Default
true.folder_namestringDefault: the export's name. Up to 100 characters.
keep_in_syncbooleanImport again about every 15 minutes (only what changed). Default
false.excludearray of stringNotion ids under the chosen pages to leave out (unticked in the picker), with everything under them. Keep in sync remembers them; pages added in Notion later still come. Up to 2,000 items.
Responses
#201Created.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.