Notion
Available Notion triggers for automating workflows
Notion provides 9 triggers for automating workflows based on events.
Trigger workflow when a comment or suggested edit is added in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
entity | object | entity output from the tool |
↳ id | string | Comment ID |
↳ entity_type | string | Entity type (comment) |
data | object | data output from the tool |
↳ page_id | string | Page ID that owns the comment thread |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page or block ID |
↳ parent_type | string | Parent type (page or block) |
Trigger workflow when a new database is created in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Trigger workflow when a database is deleted in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Trigger workflow when a database schema is modified in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Database properties updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace, or space ID |
↳ parent_type | string | Parent type: page, database, workspace, or space |
Trigger workflow when page content is changed in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Trigger workflow when a new page is created in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Trigger workflow when a page is deleted in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Trigger workflow when page properties are modified in Notion
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Property IDs updated as part of the event, when provided by Notion |
↳ parent | object | parent output from the tool |
↳ id | string | Parent page, database, workspace (space), or block ID |
↳ parent_type | string | Parent type: page, database, block, workspace, or space |
Trigger workflow on any Notion webhook event
| Parameter | Type | Required | Description |
|---|
webhookSecret | string | No | The verification_token sent by Notion during webhook setup. This same token is used to verify X-Notion-Signature HMAC headers on all subsequent webhook deliveries. |
| Parameter | Type | Description |
|---|
id | string | Webhook event ID |
type | string | Event type (e.g., page.created, database.schema_updated) |
timestamp | string | ISO 8601 timestamp of the event |
api_version | string | Notion API version included with the event |
workspace_id | string | Workspace ID where the event occurred |
workspace_name | string | Workspace name |
subscription_id | string | Webhook subscription ID |
integration_id | string | Integration ID that received the event |
attempt_number | number | Delivery attempt number (1-8 per Notion retries) |
accessible_by | array | Users and bots with access to the entity (id + type per object); type is person or bot. Omitted on some deliveries (treat as empty). |
authors | array | Actors who triggered the event (id + type per object); type is person, bot, or agent per Notion |
data | object | data output from the tool |
↳ parent | object | parent output from the tool |
↳ id | string | Parent entity ID, when provided by Notion |
↳ parent_type | string | Parent type (page, database, block, workspace, space, …), when present |
↳ page_id | string | Page ID related to the event, when present |
↳ updated_blocks | array | Blocks updated as part of the event, when provided by Notion |
↳ updated_properties | array | Updated properties included with the event, when provided by Notion |