POST/api/v1/notion/import

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

API token required20 per minute per IP

Guide: Import from Notion

Code samples and Try it

Request body

#

application/json, required

  • connection_idstring

    Default: your only Notion connection. Matches ^[A-Za-z0-9_-]{4,64}$.

  • pagesarray of objectRequired

    The pages / databases to import (their sub-pages come with them). 1–50 items.

    3 fields inside
    • idstringRequired

      A Notion page or database id. 32–36 characters.

    • kindstring

      One of page, database. One of page, database.

    • titlestring

      Shown on the page and in link previews. Up to 200 characters.

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

  • keep_in_syncboolean

    Import again about every 15 minutes (only what changed). Default false.

  • excludearray of string

    Notion 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. 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?