File upload webhooks

File upload completed

Webhook event for file upload completed in a workspace

postWebhookfileUploadCompleted

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'file_upload.completed' required

Always file_upload.completed

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.