Notion

Overview

Notion is a versatile all-in-one workspace that empowers teams to collaborate and organize seamlessly. Integrate Notion with Superblocks to effortlessly synchronize data, automate tasks, and visualize your Notion data in Superblocks.

Setting up Notion

Create an access token

To get started you'll need a Notion access token. To create a token:

1. Log in to Notion
2. Go to your Integrations page
3. Click Create new integration or choose an existing one
4. Copy the integration's access token
5. Share a database with your integration
6. Use your access token to configure your integration's connection

Learn more about Notion API Authentication

Add integration

Once you have an access token, you're ready to set up your Superblocks integration.

1. In the web app, navigate to the Integrations page
2. Click on the Notion tile
3. Name the integration
4. Paste your credentials into the relevant fields
5. Optionally, add more configurations to set credentials for different environments
6. Click Create

tip

Notion connected Now you can use Notion in any Application, Workflow, or Scheduled Job.

Use Notion in APIs

Once your Notion integration is created, you can start calling Notion actions in Superblocks APIs.

Notion actions are REST requests. To learn more about REST requests in Superblocks, see the Building REST requests guide.

Supported actions

Search

Search

Query a database

Query a database

Create a database

Create a database

Retrieve a database

Retrieves a database object using the ID specified in the request path.

Update a database

Update a database

Create a page with content

Create a page with content

Retrieve a page

Retrieves a Page object using the ID in the request path. This endpoint exposes page properties, not page content.

Update page properties

Updates a page by setting the values of any properties specified in the JSON body of the request. Properties not updated via parameters will remain unchanged.

Retrieve a page property item

Retrieve a page property item

Retrieve comments

Retrieve a user object using the ID specified in the request path.

Add comment to discussion

Add comment to discussion

Retrieve a block

Retrieve a block

Update a block

This endpoint allows you to update block content. [See Full Documentation](https://developers.notion.com/reference/update-a-block)

Delete a block

Delete a block

Retrieve block children

Retrieve block children

Append block children

Append block children

List all users

Returns a paginated list of user objects for a workspace

Retrieve a user

Retrieve a user object using the ID specified in the request path.

and 3 more

Generic HTTP Request

Every SaaS integration in Superblocks comes with a built in Generic HTTP Request Action. This is a powerful action you can use to call Notion API endpoints not in the Superblocks supported actions.

To use this action simply add the method, path, required query parameters, and body for the desired endpoint.

info

Learn more about REST requests in Superblocks in our Building REST requests guide.

Generic HTTP Requests use the authentication set up and base URL you've configured for your integration, making it an easy for your team to extend Superblocks Integrations to meet their needs.