Developer Portal Changelog Platform Status More Information Join Discord

Create Notion Feed

Create Notion feed to ingest Notion pages and databases.

Graphlit supports ingesting pages from Notion pages and databases (i.e. wikis).

The createFeed mutation enables the creation of a feed by accepting the feed name, type and notion feed parameters and it returns essential details, including the ID, name, state, and type of the newly generated feed.

Depending on the specified type parameter, Graphlit requires the specific feed parameters including the Notion identifiers, type and token.

Optionally, you can enable the reading of child pages and databases with the isRecursive flag in the Notion feed parameters.

Notion pages

When ingesting one or more Notion pages, assign the type property to PAGE, and assign the identifiers array to the list of Notion page identifiers.

For example, if you have a Notion page URL like: https://www.notion.so/workspace/My-Page-02e9a74857394304894c7d087d14cc93

The page identifier is the last segment of the page URI (after the last hyphen): 02e9a74857394304894c7d087d14cc93

Notion databases

When ingesting one or more Notion databases, assign the type property to DATABASE, and assign the identifiers array to the list of Notion database identifiers.

For example, if you have a Notion database or wiki URL like:

https://www.notion.so/workspace/2220500c1ad64ec7b5ca23d43bd2819b

The database identifier is the last segment of the URI: 2220500c1ad64ec7b5ca23d43bd2819b

Notion support requires the creation of an internal integration via the Notion developer portal.

Create your own Notion internal integration

  • Click Create New Integration

  • Select your Associated workspace

  • Enter your integration name, such as Graphlit Platform

  • Click Submit

  • Click on Capabilities, and uncheck Update content and Insert content, only allowing Read content. Click Save changes.

  • Click on Secrets, and click to show your Internal Integration Secret and copy the secret value to use as the token property when creating a Notion feed.

Add Connection to Notion page or database

Once you have your integration created, you can share any pages or databases in your Notion workspace with Graphlit, by adding your integration, as shown in this video.

Graphlit can only ingest pages or databases which have had the integration added, with the matching token used in the Notion feed.

Mutation:

mutation CreateFeed($feed: FeedInput!) {
  createFeed(feed: $feed) {
    id
    name
    state
    type
  }
}

Variables:

{
  "feed": {
    "type": "NOTION",
    "notion": {
      "token": "redacted",
      "identifiers": [
        "2220500c1ad64ec7b5ca23d43bd2819b"
      ],
      "type": "DATABASE"
    },
    "schedulePolicy": {
      "recurrenceType": "ONCE"
    },
    "name": "Notion Feed"
  }
}

Response:

{
  "type": "NOTION",
  "id": "37625012-429a-46d6-b5da-5cf928392a6c",
  "name": "Notion Feed",
  "state": "ENABLED"
}

Notion pages are internally converted to Markdown format and stored as TEXT content type.

Last updated