Notion

Notion is an all-in-one workspace for notes, tasks, wikis, and databases.

Categories: Productivity and Collaboration

Type: notion/v1

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Description	Required
clientId	Client Id	STRING		true
clientSecret	Client Secret	STRING		true

Actions

Create Page

Name: createPage

Creates a new page that is a child of an existing page.

Properties

Name	Label	Type	Description	Required
id	Parent page ID	STRING		true
title	Title	STRING	`The title of the page.`	false

Example JSON Structure

{
  "label" : "Create Page",
  "name" : "createPage",
  "parameters" : {
    "id" : "",
    "title" : ""
  },
  "type" : "notion/v1/createPage"
}

Output

Type: OBJECT

Properties

Name	Type	Description
object	STRING	The type of the object returned.
id	STRING	The ID of the page.
created_time	STRING	The time the page was created.
last_edited_time	STRING	The time the page was last edited.
created_by	OBJECT Properties {STRING(object), STRING(id)}	The user who created the page.
last_edited_by	OBJECT Properties {STRING(object), STRING(id)}	The user who last edited the page.
parent	OBJECT Properties {STRING(type), STRING(page_id)}	The parent of the page.
archived	BOOLEAN Options true, false	Whether the page is archived.
in_trash	BOOLEAN Options true, false	Whether the page is in the trash.
properties	OBJECT Properties {{STRING(id), STRING(type), [{STRING(type), {STRING(content)}(text), {BOOLEAN(bold), BOOLEAN(italic), BOOLEAN(strikethrough), BOOLEAN(underline), BOOLEAN(code), STRING(color)}(annotations), STRING(plain_text)}](title)}(title)}	The properties of the page.
url	STRING	The URL of the page.
request_id	STRING	The ID of the request.

Output Example

{
  "object" : "",
  "id" : "",
  "created_time" : "",
  "last_edited_time" : "",
  "created_by" : {
    "object" : "",
    "id" : ""
  },
  "last_edited_by" : {
    "object" : "",
    "id" : ""
  },
  "parent" : {
    "type" : "",
    "page_id" : ""
  },
  "archived" : false,
  "in_trash" : false,
  "properties" : {
    "title" : {
      "id" : "",
      "type" : "",
      "title" : [ {
        "type" : "",
        "text" : {
          "content" : ""
        },
        "annotations" : {
          "bold" : false,
          "italic" : false,
          "strikethrough" : false,
          "underline" : false,
          "code" : false,
          "color" : ""
        },
        "plain_text" : ""
      } ]
    }
  },
  "url" : "",
  "request_id" : ""
}

Get Database

Name: getDatabase

Retrieve database information by database ID.

Properties

Name	Label	Type	Description	Required
id	Database ID	STRING	`The ID of the database to retrieve.`	true

Example JSON Structure

{
  "label" : "Get Database",
  "name" : "getDatabase",
  "parameters" : {
    "id" : ""
  },
  "type" : "notion/v1/getDatabase"
}

Output

Type: OBJECT

Properties

Name	Type	Description
object	STRING	The type of the object returned.
id	STRING	The ID of the database.
created_time	STRING	The time the page was created.
last_edited_time	STRING	The time the page was last edited.
url	STRING	The URL of the database.
title	ARRAY Items [{STRING(type), {STRING(content)}(text), {BOOLEAN(bold), BOOLEAN(italic), BOOLEAN(strikethrough), BOOLEAN(underline), BOOLEAN(code), STRING(color)}(annotations), STRING(plain_text)}]
parent	OBJECT Properties {STRING(type), STRING(page_id)}	The parent of the database.
archived	BOOLEAN Options true, false	Whether the database is archived.
is_inline	BOOLEAN Options true, false
public_url	STRING	The public URL of the database.

Output Example

{
  "object" : "",
  "id" : "",
  "created_time" : "",
  "last_edited_time" : "",
  "url" : "",
  "title" : [ {
    "type" : "",
    "text" : {
      "content" : ""
    },
    "annotations" : {
      "bold" : false,
      "italic" : false,
      "strikethrough" : false,
      "underline" : false,
      "code" : false,
      "color" : ""
    },
    "plain_text" : ""
  } ],
  "parent" : {
    "type" : "",
    "page_id" : ""
  },
  "archived" : false,
  "is_inline" : false,
  "public_url" : ""
}

Get Page

Name: getPage

Retrieve page properties using page ID. Response does not contain page content.

Properties

Name	Label	Type	Description	Required
id	Page ID	STRING	`The ID of the page to retrieve.`	true

Example JSON Structure

{
  "label" : "Get Page",
  "name" : "getPage",
  "parameters" : {
    "id" : ""
  },
  "type" : "notion/v1/getPage"
}

Output

Type: OBJECT

Properties

Name	Type	Description
object	STRING	The type of the object returned.
id	STRING	The ID of the page.
created_time	STRING	The time the page was created.
last_edited_time	STRING	The time the page was last edited.
created_by	OBJECT Properties {STRING(object), STRING(id)}	The user who created the page.
last_edited_by	OBJECT Properties {STRING(object), STRING(id)}	The user who last edited the page.
parent	OBJECT Properties {STRING(type), STRING(page_id)}	The parent of the page.
archived	BOOLEAN Options true, false	Whether the page is archived.
in_trash	BOOLEAN Options true, false	Whether the page is in the trash.
properties	OBJECT Properties {{STRING(id), STRING(type), [{STRING(type), {STRING(content)}(text), {BOOLEAN(bold), BOOLEAN(italic), BOOLEAN(strikethrough), BOOLEAN(underline), BOOLEAN(code), STRING(color)}(annotations), STRING(plain_text)}](title)}(title)}	The properties of the page.
url	STRING	The URL of the page.
request_id	STRING	The ID of the request.

Output Example

{
  "object" : "",
  "id" : "",
  "created_time" : "",
  "last_edited_time" : "",
  "created_by" : {
    "object" : "",
    "id" : ""
  },
  "last_edited_by" : {
    "object" : "",
    "id" : ""
  },
  "parent" : {
    "type" : "",
    "page_id" : ""
  },
  "archived" : false,
  "in_trash" : false,
  "properties" : {
    "title" : {
      "id" : "",
      "type" : "",
      "title" : [ {
        "type" : "",
        "text" : {
          "content" : ""
        },
        "annotations" : {
          "bold" : false,
          "italic" : false,
          "strikethrough" : false,
          "underline" : false,
          "code" : false,
          "color" : ""
        },
        "plain_text" : ""
      } ]
    }
  },
  "url" : "",
  "request_id" : ""
}

On this page