Notion (Independent Publisher)

  • Reference

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

Operation ID:
Listofallusers

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

Operation ID:
RetrieveBlock

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

Operation ID:
RetrieveADatabase

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

Operation ID:
RetrieveBlockChildren

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

Operation ID:
RetrieveUser

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.
Operation ID:
Search

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)

Operation ID:
UpdateaBlock

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'.