Comment webhooks

Comment created

Webhook event for comment created in a workspace

postWebhookcommentCreated

Payload

idstring required

Unique identifier for this webhook event.

timestampstring required

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

workspace_idstring uuid required
workspace_namestring required

The name of the workspace where the event originated.

subscription_idstring uuid required
integration_idstring uuid required
attempt_numberinteger required

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

api_version'2022-06-28' | '2025-09-03' | '2026-03-11' required

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

type'comment.created' required

Always comment.created

Response

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

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.