Notion webhook events
31 Notion event types in 6 resources. 23 have sample payloads.
These pages cover connection webhooks, which a connection subscribes to and Notion signs. The Send webhook action in buttons and database automations is a separate no-code feature: it POSTs the properties you pick to a URL, and Notion documents no signature for it.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
comment
comment.created
documented from Notion docs (example)
comment.created Comment or suggested edit added to a page or block
Identified by type field in the body
Resource comment
{
"id": "c6780f24-10b7-4f42-a6fd-230b6cf7ad69",
"timestamp": "2024-12-05T20:46:45.854Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "comment.created",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | c6780f24-10b7-4f42-a6fd-230b6cf7ad69 |
type | string | comment.created |
timestamp | string | 2024-12-05T20:46:45.854Z |
Full schema: 24 fields.
From Notion docs
-
Content type
application/json
comment.updated
documented from Notion docs (example)
comment.updated Comment edited, or its attached file finishes uploading
Identified by type field in the body
Resource comment
{
"id": "68ad06e4-5b68-498d-8812-9a1d3e069e46",
"timestamp": "2024-12-05T20:47:22.657Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "comment.updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 68ad06e4-5b68-498d-8812-9a1d3e069e46 |
type | string | comment.updated |
timestamp | string | 2024-12-05T20:47:22.657Z |
Full schema: 24 fields.
From Notion docs
-
Content type
application/json
comment.deleted
documented from Notion docs (example)
comment.deleted Comment is removed
Identified by type field in the body
Resource comment
{
"id": "aa4436d0-6694-49ad-aabb-55c6307f091b",
"timestamp": "2024-12-05T20:49:08.688Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "comment.deleted",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | aa4436d0-6694-49ad-aabb-55c6307f091b |
type | string | comment.deleted |
timestamp | string | 2024-12-05T20:49:08.688Z |
Full schema: 24 fields.
From Notion docs
-
Content type
application/json
data_source
data_source.created
documented from Notion docs (example)
data_source.created Data source added to an existing database
Identified by type field in the body
Resource data_source
{
"id": "6f6469cb-8022-409d-a560-62e631a84d74",
"timestamp": "2025-09-03T17:24:49.997Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"authors": [ … ],
"attempt_number": 1,
"api_version": "2025-09-03",
"entity": { … },
"type": "data_source.created"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6f6469cb-8022-409d-a560-62e631a84d74 |
type | string | data_source.created |
timestamp | string | 2025-09-03T17:24:49.997Z |
Full schema: 20 fields.
From Notion docs
-
Content type
application/json
data_source.content_updated
documented from Notion docs (example)
data_source.content_updated Data source content changes, such as a child page added
Identified by type field in the body
Resource data_source
{
"id": "25e44fe0-6785-45bb-adc2-a321526c12c5",
"timestamp": "2024-12-13T17:48:13.700Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "data_source.content_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 25e44fe0-6785-45bb-adc2-a321526c12c5 |
type | string | data_source.content_updated |
timestamp | string | 2024-12-13T17:48:13.700Z |
Full schema: 27 fields.
From Notion docs
-
Content type
application/json
data_source.schema_updated
documented from Notion docs (example)
data_source.schema_updated Data source properties added, changed or removed
Identified by type field in the body
Resource data_source
{
"id": "5496f509-6988-4bab-b6a9-bdce0b720ca0",
"timestamp": "2024-12-05T23:55:22.243Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "data_source.schema_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 5496f509-6988-4bab-b6a9-bdce0b720ca0 |
type | string | data_source.schema_updated |
timestamp | string | 2024-12-05T23:55:22.243Z |
Full schema: 28 fields.
From Notion docs
-
Content type
application/json
data_source.deleted
documented from Notion docs (example)
data_source.deleted Data source goes to the trash
Identified by type field in the body
Resource data_source
{
"id": "4e443c81-a332-40af-9300-c7eb6e514737",
"timestamp": "2025-09-03T17:54:38.833Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"authors": [ … ],
"attempt_number": 1,
"api_version": "2025-09-03",
"entity": { … },
"type": "data_source.deleted"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 4e443c81-a332-40af-9300-c7eb6e514737 |
type | string | data_source.deleted |
timestamp | string | 2025-09-03T17:54:38.833Z |
Full schema: 20 fields.
From Notion docs
-
Content type
application/json
data_source.moved
documented from Notion docs (example)
data_source.moved Data source moves to a different database
Identified by type field in the body
Resource data_source
{
"id": "b6cc0a2c-f8f6-440b-920d-e3d6d7cf2e44",
"timestamp": "2025-09-03T17:49:13.978Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"authors": [ … ],
"attempt_number": 1,
"api_version": "2025-09-03",
"entity": { … },
"type": "data_source.moved"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | b6cc0a2c-f8f6-440b-920d-e3d6d7cf2e44 |
type | string | data_source.moved |
timestamp | string | 2025-09-03T17:49:13.978Z |
Full schema: 20 fields.
From Notion docs
-
Content type
application/json
data_source.undeleted
documented from Notion docs (example)
data_source.undeleted Data source comes back from the trash
Identified by type field in the body
Resource data_source
{
"id": "afc2475f-aaeb-4a69-8158-b654ba4bc47b",
"timestamp": "2025-09-03T17:55:42.075Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"authors": [ … ],
"attempt_number": 1,
"api_version": "2025-09-03",
"entity": { … },
"type": "data_source.undeleted"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | afc2475f-aaeb-4a69-8158-b654ba4bc47b |
type | string | data_source.undeleted |
timestamp | string | 2025-09-03T17:55:42.075Z |
Full schema: 20 fields.
From Notion docs
-
Content type
application/json
database
database.created
documented from Notion docs (example)
database.created Database created with a default data source
Identified by type field in the body
Resource database
{
"id": "d0bd8927-0826-4db0-9e26-83d57253f1ff",
"timestamp": "2024-12-05T23:50:35.868Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.created",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | d0bd8927-0826-4db0-9e26-83d57253f1ff |
type | string | database.created |
timestamp | string | 2024-12-05T23:50:35.868Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
database.schema_updated
documented from Notion docs (example)
database.schema_updated Database properties change, on API versions before 2025-09-03
Identified by type field in the body
Resource database
{
"id": "5496f509-6988-4bab-b6a9-bdce0b720ca0",
"timestamp": "2024-12-05T23:55:22.243Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.schema_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 5496f509-6988-4bab-b6a9-bdce0b720ca0 |
type | string | database.schema_updated |
timestamp | string | 2024-12-05T23:55:22.243Z |
Full schema: 28 fields.
From Notion docs
-
Content type
application/json
database.content_updated
documented from Notion docs (example)
database.content_updated Database content changes, on API versions before 2025-09-03
Identified by type field in the body
Resource database
{
"id": "25e44fe0-6785-45bb-adc2-a321526c12c5",
"timestamp": "2024-12-13T17:48:13.700Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.content_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 25e44fe0-6785-45bb-adc2-a321526c12c5 |
type | string | database.content_updated |
timestamp | string | 2024-12-13T17:48:13.700Z |
Full schema: 27 fields.
From Notion docs
-
Content type
application/json
database.deleted
documented from Notion docs (example)
database.deleted Database goes to the trash
Identified by type field in the body
Resource database
{
"id": "c00e2ea7-032a-4e20-ae05-d69028a09ae9",
"timestamp": "2024-12-05T23:51:27.295Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.deleted",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | c00e2ea7-032a-4e20-ae05-d69028a09ae9 |
type | string | database.deleted |
timestamp | string | 2024-12-05T23:51:27.295Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
database.moved
documented from Notion docs (example)
database.moved Database moves to a different parent
Identified by type field in the body
Resource database
{
"id": "f9c70013-d79d-4c4e-8d5b-939429949a2e",
"timestamp": "2024-12-06T06:54:08.468Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.moved",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | f9c70013-d79d-4c4e-8d5b-939429949a2e |
type | string | database.moved |
timestamp | string | 2024-12-06T06:54:08.468Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
database.undeleted
documented from Notion docs (example)
database.undeleted Database comes back from the trash
Identified by type field in the body
Resource database
{
"id": "edd8ff6e-0f07-4621-934b-76ca55129cc2",
"timestamp": "2024-12-05T23:52:16.149Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "database.undeleted",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | edd8ff6e-0f07-4621-934b-76ca55129cc2 |
type | string | database.undeleted |
timestamp | string | 2024-12-05T23:52:16.149Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
file_upload
file_upload.created
documented No payload yet
file_upload.created File upload object created
Identified by type field in the body
Resource file_upload
No payload yet.
file_upload.completed
documented No payload yet
file_upload.completed External file import finishes successfully
Identified by type field in the body
Resource file_upload
No payload yet.
file_upload.expired
documented No payload yet
file_upload.expired File upload expires before it's completed and attached
Identified by type field in the body
Resource file_upload
No payload yet.
file_upload.upload_failed
documented No payload yet
file_upload.upload_failed External file import fails, with the error in the body
Identified by type field in the body
Resource file_upload
No payload yet.
page
page.content_updated
documented from Notion docs (example)
page.content_updated Page content changes, such as a block added or removed
Identified by type field in the body
Resource page
{
"id": "56c3e00c-4f0c-4566-9676-4b058a50a03d",
"timestamp": "2024-12-05T19:49:36.997Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.content_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 56c3e00c-4f0c-4566-9676-4b058a50a03d |
type | string | page.content_updated |
timestamp | string | 2024-12-05T19:49:36.997Z |
Full schema: 27 fields.
From Notion docs
-
Content type
application/json
page.properties_updated
documented from Notion docs (example)
page.properties_updated A property value on a page changes
Identified by type field in the body
Resource page
{
"id": "1782edd6-a853-4d4a-b02c-9c8c16f28e53",
"timestamp": "2024-12-05T23:57:05.379Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.properties_updated",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 1782edd6-a853-4d4a-b02c-9c8c16f28e53 |
type | string | page.properties_updated |
timestamp | string | 2024-12-05T23:57:05.379Z |
Full schema: 25 fields.
From Notion docs
-
Content type
application/json
page.created
documented from Notion docs (example)
page.created New page appears where your connection has access
Identified by type field in the body
Resource page
{
"id": "367cba44-b6f3-4c92-81e7-6a2e9659efd4",
"timestamp": "2024-12-05T23:55:34.285Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.created",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 367cba44-b6f3-4c92-81e7-6a2e9659efd4 |
type | string | page.created |
timestamp | string | 2024-12-05T23:55:34.285Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.deleted
documented from Notion docs (example)
page.deleted Page goes to the trash
Identified by type field in the body
Resource page
{
"id": "ea6b8136-1db6-4f2e-b157-84a532437f62",
"timestamp": "2024-12-05T23:59:31.215Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.deleted",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | ea6b8136-1db6-4f2e-b157-84a532437f62 |
type | string | page.deleted |
timestamp | string | 2024-12-05T23:59:31.215Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.undeleted
documented from Notion docs (example)
page.undeleted Page comes back from the trash
Identified by type field in the body
Resource page
{
"id": "ec37232c-a17b-4f02-bb7c-8d8e1f5f2250",
"timestamp": "2024-12-06T00:00:03.356Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.undeleted",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | ec37232c-a17b-4f02-bb7c-8d8e1f5f2250 |
type | string | page.undeleted |
timestamp | string | 2024-12-06T00:00:03.356Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.locked
documented from Notion docs (example)
page.locked Page is locked against edits
Identified by type field in the body
Resource page
{
"id": "e2a3092c-5af0-442f-9d11-b813145edb72",
"timestamp": "2024-12-06T00:00:56.480Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.locked",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | e2a3092c-5af0-442f-9d11-b813145edb72 |
type | string | page.locked |
timestamp | string | 2024-12-06T00:00:56.480Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.unlocked
documented from Notion docs (example)
page.unlocked Page lock is removed
Identified by type field in the body
Resource page
{
"id": "e2a3092c-5af0-442f-9d11-b813145edb72",
"timestamp": "2024-12-06T00:00:56.480Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.unlocked",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | e2a3092c-5af0-442f-9d11-b813145edb72 |
type | string | page.unlocked |
timestamp | string | 2024-12-06T00:00:56.480Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.moved
documented from Notion docs (example)
page.moved Page moves to a new location
Identified by type field in the body
Resource page
{
"id": "7de99a6f-2edd-4116-bf59-2d09407bddec",
"timestamp": "2024-12-11T05:43:14.383Z",
"workspace_id": "13950b26-c203-4f3b-b97d-93ec06319565",
"workspace_name": "Quantify Labs",
"subscription_id": "29d75c0d-5546-4414-8459-7b7a92f1fc4b",
"integration_id": "0ef2e755-4912-8096-91c1-00376a88a5ca",
"type": "page.moved",
"authors": [ … ],
"accessible_by": [ … ],
"attempt_number": 1,
"entity": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 7de99a6f-2edd-4116-bf59-2d09407bddec |
type | string | page.moved |
timestamp | string | 2024-12-11T05:43:14.383Z |
Full schema: 23 fields.
From Notion docs
-
Content type
application/json
page.transcription_block.transcript_deleted
documented No payload yet
page.transcription_block.transcript_deleted Transcript deleted from a page's transcription block
Identified by type field in the body
Resource page
No payload yet.
view
view.created
documented No payload yet
view.created Database view created, with its view type in the body
Identified by type field in the body
Resource view
No payload yet.
view.updated
documented No payload yet
view.updated Database view's name, filter, sorts or configuration changes
Identified by type field in the body
Resource view
No payload yet.
view.deleted
documented No payload yet
view.deleted Database view deleted
Identified by type field in the body
Resource view
No payload yet.
Route Notion events by type.
Event Gateway receives every Notion delivery and filters and routes it by event type, so each service gets only the events it handles.