/api/v1/imports/notionStart a Notion import
Opens an import of a Notion export zip (Export › Markdown & CSV, Include subpages on), up to 2 GB, and returns it (import, state uploading) with upload: a URL to PUT the zip to, with its Content-Type header, valid 6 hours. destination: workspace (omit for My files), team (omit for company-wide), an existing folder, new_folder (default true: a new folder named folder_name, default the export's name; importing again with the same name merges into it). Imported items get the destination's default access, never public. 413 over 2 GB, 415 not a .zip, 429 with 3 imports going.
Guide: Import from Notion
Code samples and Try itRequest body
#application/json, required
file_namestringRequired1–255 characters.
size_bytesintegerRequiredAt least 1.
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.
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.