---
title: "File upload failed"
method: POST
path: "fileUploadUploadFailed"
tags: ["File upload webhooks"]
---

# File upload failed

`POST fileUploadUploadFailed` (webhook)

Webhook event for file upload upload failed in a workspace

## Payload

- FileUploadUploadFailedWebhookPayload
  - `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
  - `workspace_name` string, required — The name of the workspace where the event originated.
  - `subscription_id` string, uuid, required
  - `integration_id` string, uuid, required
  - `authors` union[], required — The users or bots that performed the action. Typically an array of length 1; can be more for aggregated events.
    - union
      - object
        - `id` string, uuid, required
        - `type` 'person', required — Always `person`
      - object
        - `id` string, uuid, required
        - `type` 'bot', required — Always `bot`
  - `attempt_number` integer, 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.
  - `accessible_by` union[] — 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.
    - union
      - object
        - `id` string, uuid, required
        - `type` 'person', required — Always `person`
      - object
        - `id` string, uuid, required
        - `type` 'bot', required — Always `bot`
  - `type` 'file_upload.upload_failed', required — Always `file_upload.upload_failed`
  - `entity` WebhookFileUploadEntity, required
    - `type` 'file_upload', required — Always `file_upload`
    - `id` string, uuid, required
  - `data` object, required — Additional event-specific data.
    - `file_import_result` union, required — The result of the file import attempt.
      - object
        - `type` 'success', required — Always `success`
        - `imported_time` string, required — ISO 8601 timestamp of when the file was imported.
        - `success` EmptyObject, required
      - object
        - `type` 'error', required — Always `error`
        - `imported_time` string, required — ISO 8601 timestamp of when the import was attempted.
        - `error` object, required — Details about the error.
          - `type` 'validation_error' | 'internal_system_error' | 'download_error' | 'upload_error', required — The category of the error.
          - `code` string, required — A machine-readable error code.
          - `message` string, required — A human-readable description of the error.
          - `parameter` string, nullable, required — The parameter that caused the error, or `null`.
          - `status_code` integer, nullable, required — The HTTP status code associated with the error, or `null`.

## Acknowledgement `200`

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

---

[API](https://skmtc.net/notion/apis/notion-api.md) · [All operations](https://skmtc.net/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/dee5763763b0/schema)