> Main > Integrations > Notion
Version main

Notion Integration documentation

Overview

The Notion integration allows you to back up and restore your Notion pages or entire workspace into a Plakar repository using the official Notion API.

All content is fetched via the API and stored as structured JSON, including page metadata, content blocks, and hierarchical relationships.

Backup

Configuration

Example Usage

1$ plakar source add mynotion location=notion:// token=$NOTION_API_TOKEN
2$ plakar at @kloset backup @mynotion

To create a source called mynotion and back it up in the specified kloset.

Restore

Configuration

  • A valid Notion API token (ntn_xxx)
  • A valid Notion Page ID where you want to restore the content, shared with the integration with write access → See Notion’s developer guide for how to create and share integrations.

To get id of a Notion page, you can open the page in your browser and copy the ID from the URL. It looks like a long alphanumeric string.

https://www.notion.so/MyNotionPageName-1234567890abcdef1234567890abcdef

Here the ID is 1234567890abcdef1234567890abcdef.

Example Usage

1$ plakar destination add mynotion location=notion:// token=$NOTION_API_TOKEN
2$ plakar destination set mynotion rootId=$NOTION_PAGE_ID
3$ plakar at @kloset restore -to notion:// <snapshot_id>

This command creates a destination called mynotion associated with the integration token, then sets the rootID parameter, and finally restores the <snapshot_id> content to it.

Use plakar ls to list available snapshots.

Questions, Feedback, and Support

Found a bug? Suggestion? Open an issue on GitHub.

Join our Discord community for real-time help and discussions.