POST/api/v1/imports/notion

Start 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.

API token required20 per minute per IP

Guide: Import from Notion

Code samples and Try it

Request body

#

application/json, required

  • file_namestringRequired

    1–255 characters.

  • size_bytesintegerRequired

    At least 1.

  • destinationobject
    5 fields inside
    • workspacestring

      File it in this workspace: the workspace's id. Up to 64 characters.

    • teamstring

      A team's id, slug or name; empty: company-wide. Up to 100 characters.

    • folderstring

      An existing folder of workspace: its id or its path, like guides/setup. Up to 500 characters.

    • new_folderboolean

      Put everything in a new folder (My files: a page) named folder_name. Default true.

    • folder_namestring

      Default: the export's name. Up to 100 characters.

Responses

#
  • 201Created.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?