Introduction

In this guide we'll walk through the process of linking Cerb to Notion, a collaborative notebook and planner. You'll be able to use Notion's full API for any automations you wish to make.

Get a Notion API Key.

Go to your integrations page and click New integration.

Name the integration and select the associated workspace and type (internal). You can also add a logo if you'd like.

Click Show and then Copy to the right of the Internal Integration Secret box.

Create the Notion service in Cerb

Navigate to Search » Connected Services.
Click the (+) icon in the top right of the list.
Select Notion.
Paste the key you copied earlier in the Integration Secret field.
Click the Create button.

Examples

List users

https://developers.notion.com/reference/get-users

start:
  http.request/listUsers:
    output: http_response
    inputs:
      method: GET
      url: https://api.notion.com/v1/users
      authentication: cerb:connected_account:notion
      headers:
        Notion-Version: 2022-02-22
    on_success:
      set:
        response@json: {{http_response.body}}
        http_response@json: null

Search

https://developers.notion.com/reference/search

start:
  http.request/search:
    output: http_response
    inputs:
      method: POST
      url: https://api.notion.com/v1/search
      authentication: cerb:connected_account:notion
      headers:
        Content-Type: application/json
        Notion-Version: 2022-06-28
      body:
        query: Docs
        filter:
          value: page
          property: object
        sort:
          direction: ascending
          timestamp: last_edited_time
    on_success:
      set:
        response@json: {{http_response.body}}
        http_response@json: null