Contact Us 1-800-596-4880
  1. Homepage
  2. Notion Connector (0.1)

  3. Notion Connector Reference

All Connectors

Notion Connector 0.1.0 Reference

Configurations

Config

Default configuration.

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

Bearer Auth

The connection types to provide to this configuration.

x

Name

String

The identifier of this element used to reference it in other components.

x

Expiration Policy

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Connection Types

Bearer Auth
Parameters
Name Type Description Default Value Required

baseUri

String

The base URI for the Notion API.

x

token

String

The authentication token for accessing the Notion API.

x

TLS Configuration

Tls

Configures TLS to provide secure communications for the connector.

Reconnection

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Supported Operations

Operations

Append Block Children

<notion:append-block-children>

Appends block children to a parent block.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the block to append children to.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the children blocks to append.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Create A Database

<notion:create-a-database>

Creates a database in a parent page or workspace.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the database properties.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:UNAUTHORIZED

Create A Page

<notion:create-a-page>

Creates a page.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the page properties.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Create Comments

<notion:create-comments>

Creates comments.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the comment content.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Delete Block

<notion:delete-block>

Deletes a block.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the block to delete.

x

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Get Block By Id

<notion:get-block-by-id>

Retrieves a block by its identifier.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the block to retrieve.

x

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Get Block Children

<notion:get-block-children>

Retrieves the children blocks of a parent block.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the parent block.

x

page_size

Number

The number of items to return per page.

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Array of Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Get Page Property Item

<notion:get-page-property-item>

Retrieves a specific property item from a page.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

page_id

String

The identifier of the page.

x

property_id

String

The identifier of the property.

x

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Get User by Id

<notion:get-user-by-id>

Retrieves a user by their identifier.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the user to retrieve.

x

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

List Comments

<notion:list-comments>

Lists comments.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

block_id

String

The identifier of the block to list comments for.

page_size

Number

The number of items to return per page.

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Array of Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

List Users

<notion:list-users>

Lists users.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

page_size

Number

The number of items to return per page.

start_cursor

String

The cursor for pagination to start from.

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Array of Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Retrieve A Comment

<notion:retrieve-a-comment>

Retrieves a specific comment by its identifier.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

comment_id

String

The identifier of the comment to retrieve.

x

Notion-Version

String

The Notion API version to use.

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:UNAUTHORIZED

Search By Title

<notion:search-by-title>

Searches by title.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the search query.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Array of Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Update Block

<notion:update-block>

Updates the content of a block.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

ID

String

The identifier of the block to update.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the updated block properties.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Update Page

<notion:update-page>

Updates the page.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

page_id

String

The identifier of the page to update.

x

Notion-Version

String

The Notion API version to use.

body

Any

The request body containing the updated page properties.

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:NOT_FOUND

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

usersMe

<notion:users-me>

Retrieves information about the user.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Notion-Version

String

The Notion API version to use.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Error Mappings

Array of Error Mapping

Set of error mappings.

Output

Type

Any

Attributes Type

Any

For Configurations

Throws

  • NOTION:BAD_REQUEST

  • NOTION:CLIENT_ERROR

  • NOTION:CONNECTIVITY

  • NOTION:FORBIDDEN

  • NOTION:SECURITY

  • NOTION:SERVER_ERROR

  • NOTION:TIMEOUT

  • NOTION:TOO_MANY_REQUESTS

  • NOTION:UNAUTHORIZED

Types

Tls

Field Type Description Default Value Required

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Trust Store

Configures the TLS trust store.

Key Store

Key Store

Configures the TLS key store.

Revocation Check

Configures certificate revocation checking.

Trust Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

Key Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the key store.

Algorithm

String

The algorithm used by the key store.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

Custom Ocsp Responder

Field Type Description Default Value Required

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

Crl File

Field Type Description Default Value Required

Path

String

The path to the CRL file.

Reconnection

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread.

Count

Number

How many reconnection attempts to make.

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

Blocking

Boolean

If false, the reconnection strategy will run in a separate, non-blocking thread.

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Time unit that qualifies the Max Idle Time attribute.

Error Mapping

Field Type Description Default Value Required

Source

Enumeration, one of:

  • ANY

  • REDELIVERY_EXHAUSTED

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY

  • SERVER_SECURITY

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED

  • TIMEOUT

The source error type to map from.

Target

String

The target error type to map to.

x

Repeatable In Memory Iterable

Field Type Description Default Value Required

Initial Buffer Size

Number

The amount of instances that is initially be allowed to be kept in memory to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize. Default value is 100 instances.

Buffer Size Increment

Number

This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full. Default value is 100 instances.

Max Buffer Size

Number

The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.

Repeatable File Store Iterable

Field Type Description Default Value Required

In Memory Objects

Number

The maximum amount of instances to keep in memory. If more than that is required, content on the disk is buffered.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

Unit for the In Memory Objects field.
Back to top
View on GitHub