Skip to main content

Synced Objects

Notion supports the following Synced Objects:
  • Files

    Notion pages are synced as Markdown files.

    • All child pages (including entries of a database) will be synced as distinct files with their parentId set to the ID of the parent page or database.
    • Properties of database entries are currently not synced, except for the Title property, which will become the file name.
    • Pages that have no title will produce a synced file with an empty fileName.
    • Attachments and images are represented as links within the page Markdown and must be downloaded separately.

Files

Send a request to Enable Sync to start a file sync. Syncs for Notion can be created with one of the following configurations:
  • Global Sync: All pages and databases that are granted to the integration at time of authentication will be synced.
    Note: Due to limitations with Notion’s search API, Global Sync is not guaranteed to be exhaustive; newly created or recently modified pages may be missing after the initial sync.Any pages not captured will be included when they are updated by the user or in the next scheduled periodic full sync, which runs every 24 hours.You can alternatively use a Sync of specific pages to explicitly designate page root(s) based on a user selection, which will guarantee that those pages and their descendants will always be fully synced.
  • Sync of specific pages: Only a group of specific pages and their descendants will be synced. Use this option when your users will select pages in your UI to sync from Notion. Page-specific syncs use Notion’s hierarchy traversal API from the roots specified in configuration.pageIds, so all pages under the specified roots are always synced completely.
Example
{
    "integration": "notion",
    "pipeline": "files",
    "configuration": {}
}
Configuration options:No configuration options are required for a global Sync.