Skip to content

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

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" : ""
}