ByteChef LogoByteChef
Components

Notion

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

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

NameLabelTypeDescriptionRequired
clientIdClient IdSTRINGtrue
clientSecretClient SecretSTRINGtrue

Actions

Create Page

Name: createPage

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

Properties

NameLabelTypeDescriptionRequired
idParent page IDSTRINGtrue
titleTitleSTRINGThe title of the page.false

Example JSON Structure

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

Output

Type: OBJECT

Properties

NameTypeDescription
objectSTRINGThe type of the object returned.
idSTRINGThe ID of the page.
created_timeSTRINGThe time the page was created.
last_edited_timeSTRINGThe time the page was last edited.
created_byOBJECT
Properties {STRING(object), STRING(id)}
The user who created the page.
last_edited_byOBJECT
Properties {STRING(object), STRING(id)}
The user who last edited the page.
parentOBJECT
Properties {STRING(type), STRING(page_id)}
The parent of the page.
archivedBOOLEAN
Options true, false
Whether the page is archived.
in_trashBOOLEAN
Options true, false
Whether the page is in the trash.
propertiesOBJECT
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.
urlSTRINGThe URL of the page.
request_idSTRINGThe 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

NameLabelTypeDescriptionRequired
idDatabase IDSTRINGThe 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

NameTypeDescription
objectSTRINGThe type of the object returned.
idSTRINGThe ID of the database.
created_timeSTRINGThe time the page was created.
last_edited_timeSTRINGThe time the page was last edited.
urlSTRINGThe URL of the database.
titleARRAY
Items [{STRING(type), {STRING(content)}(text), {BOOLEAN(bold), BOOLEAN(italic), BOOLEAN(strikethrough), BOOLEAN(underline), BOOLEAN(code), STRING(color)}(annotations), STRING(plain_text)}]
parentOBJECT
Properties {STRING(type), STRING(page_id)}
The parent of the database.
archivedBOOLEAN
Options true, false
Whether the database is archived.
is_inlineBOOLEAN
Options true, false
public_urlSTRINGThe 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

NameLabelTypeDescriptionRequired
idPage IDSTRINGThe 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

NameTypeDescription
objectSTRINGThe type of the object returned.
idSTRINGThe ID of the page.
created_timeSTRINGThe time the page was created.
last_edited_timeSTRINGThe time the page was last edited.
created_byOBJECT
Properties {STRING(object), STRING(id)}
The user who created the page.
last_edited_byOBJECT
Properties {STRING(object), STRING(id)}
The user who last edited the page.
parentOBJECT
Properties {STRING(type), STRING(page_id)}
The parent of the page.
archivedBOOLEAN
Options true, false
Whether the page is archived.
in_trashBOOLEAN
Options true, false
Whether the page is in the trash.
propertiesOBJECT
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.
urlSTRINGThe URL of the page.
request_idSTRINGThe 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