Skip to main content
WEBHOOK
viewUpdated
{
  "id": "<string>",
  "timestamp": "<string>",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workspace_name": "<string>",
  "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "integration_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "<string>"
    }
  ],
  "attempt_number": 123,
  "api_version": "2022-06-28",
  "type": "<string>",
  "entity": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "<string>"
  },
  "data": {
    "parent": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "space",
      "data_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "updated_fields": [
      "name"
    ]
  },
  "accessible_by": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "type": "<string>"
    }
  ]
}

Body

application/json
​
id
string
required

Unique identifier for this webhook event.

​
timestamp
string
required

ISO 8601 timestamp of when the event occurred. Can be used to order events.

​
workspace_id
string<uuid>
required

The ID of the workspace where the event originated.

​
workspace_name
string
required

The name of the workspace where the event originated.

​
subscription_id
string<uuid>
required

The ID of the webhook subscription.

​
integration_id
string<uuid>
required

The ID of the integration the subscription is set up with.

​
authors
object[]
required

The users or bots that performed the action. Typically an array of length 1; can be more for aggregated events.

Maximum array length: 100
​
attempt_number
integer
required

The delivery attempt number (1-8) of the current event delivery.

​
api_version
enum<string>
required

The Notion API version that was used to render this webhook event's shape.

Available options:
2022-06-28,
2025-09-03,
2026-03-11
​
type
string
required

Always view.updated

Allowed value: "view.updated"
​
entity
object
required

The object that triggered the event.

​
data
object
required

Additional event-specific data.

​
accessible_by
object[]

The users or bots who own the bot connection to the integration_id and have access to the webhook's entity. Only present for public integrations.

Maximum array length: 100

Response

200

Return an HTTP 200 status code to indicate that the data was received successfully.