Notion (Independent Publisher) (Preview)

Notion connector use the API to access Notion's pages, databases, and users.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Chandra Sekhar & Harshini Varma
URL https://github.com/sekharmalla
Email Sekharmalla.vfx@gmail.com
Connector Metadata
Publisher Chandra Sekhar & Harshini Varma
Website https://www.notion.so/
Privacy policy https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
Categories Productivity;collaboration

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

List of all users

Returns a paginated list of Users for the workspace

Retrieve a block

Retrieves a Block object using the ID specified.

Retrieve a database

Retrieves a Database object using the ID specified.

Retrieve block children

Returns a paginated array of child block objects contained in the block using the ID specified

Retrieve User

Retrieves a User using the ID specified.

Search

Searches all pages and child pages that are shared with the integration. The results may include databases.

Update a block (to-do)

Updates the content for the specified block_id based on the block type to-do.

List of all users

Returns a paginated list of Users for the workspace

Parameters

Name Key Required Type Description
Page size
page_size integer

The number of items from the full list desired in the response. Maximum: 100

Returns

Name Path Type Description
Id
id string

Identifier for a Notion block

Display Name
name string

User's name displayed in Notion.

Avatar URL
avatar_url string

Chosen avatar image.

Type
type string

Type of the user. Possible values are "person" and "bot".

Email
email string

Email address of person.

Next Cursor
next_cursor string

A cursor returned used to request the next page of results. Treat this as an opaque value

Has more
has_more boolean

When the response includes the end of the list

Retrieve a block

Retrieves a Block object using the ID specified.

Parameters

Name Key Required Type Description
Block id
block_id True string

Identifier for the block.

Returns

Name Path Type Description
Id
id string

Identifier for the block.

Created time
created_time date-time

Date and time when this block was created.

Last edited time
last_edited_time date-time

Date and time when this block was last updated.

Has children
has_children boolean

Whether or not the block has children blocks nested within it.

Archived
archived boolean

The archived status of the block.

Type
type string

The type of the block

Title
title string

Rich text in the paragraph block.

Retrieve a database

Retrieves a Database object using the ID specified.

Parameters

Name Key Required Type Description
Database id
database_id True string

Identifier for a Notion database

Returns

response
object

Retrieve block children

Returns a paginated array of child block objects contained in the block using the ID specified

Parameters

Name Key Required Type Description
Block id
block_id True string

Identifier for a block

Page size
page_size integer

The number of items from the full list desired in the response. Maximum: 100

Returns

Name Path Type Description
id
items.id string

Identifier for the block.

Created time
items.created_time date-time

Date and time when this block was created.

Last edited time
items.last_edited_time date-time

Date and time when this block was last updated.

Has children
items.has_children boolean

Whether or not the block has children blocks nested within it.

Archived
items.archived boolean

The archived status of the block.

Type
items.type string

Type of block. Possible values

Plain text
plain_text string

Plain text in the paragraph block plain_text

Next cursor
next_cursor string

A cursor returned used to request the next page of results. Treat this as an opaque value

Has more
has_more boolean

Whether or not the block has more blocks or not

Retrieve User

Retrieves a User using the ID specified.

Parameters

Name Key Required Type Description
User ID
user_id True string

Unique identifier for this user.

Returns

Name Path Type Description
object
object string

Name of the object always user.

Id
id string

Identifier for a Notion user

User Name
name string

Name of the User

Avatar URL
avatar_url string

Chosen avatar image

Email
email string

Email address of person.

Searches all pages and child pages that are shared with the integration. The results may include databases.

Parameters

Name Key Required Type Description
Query
query True string

When supplied, limits which pages are returned by comparing the query to the page title.

Direction
direction string

The direction to sort. Possible values include ascending and descending.

Timestamp
timestamp string

The name of the timestamp to sort against. Possible values include last_edited_time.

Returns

Name Path Type Description
Object
object string

Name of the object.

id
id string

Identifier for the block.

Created time
created_time string

Date and time when this page was created.

Last edited time
last_edited_time string

Date and time when this page was updated.

Plain text
plain_text string

The plain text without annotations.

Tags
Tags object

The tags object contains the list of tags.

URL
url string

The URL of the object.

Next cursor
next_cursor string

A cursor returned used to request the next page of results. Treat this as an opaque value

Has more
has_more boolean

Whether or not the block has more blocks or not.

Update a block (to-do)

Updates the content for the specified block_id based on the block type to-do.

Parameters

Name Key Required Type Description
Block id
block_id True string

Identifier for a Notion block

content
content string

content

Returns

Name Path Type Description
Object
object string

Name of the object.

Id
id string

Identifier for a Notion block

Created time
created_time string

Date and time when this page was created.

Last edited time
last_edited_time date-time

Date and time when this block was last updated.

Has children
has_children boolean

Whether or not the block has children blocks nested within it.

Type
type string

Type of block. Possible values

archived
archived boolean

The archived status of the block.

Content
content string

Updates the content for the specified block_id based on the block type.

Plain text
plain_text string

Plain text in the paragraph block plain_text

Definitions

object

This is the type 'object'.