---
title: "media.failed"
method: POST
path: "media.failed"
---

# media.failed

`POST media.failed` (webhook)

A media attachment failed to process or download.

## Payload

- WebhookEventMediaFailed: Envelope shared by every webhook delivery.
  - `id` string, required: Delivery ID, prefixed with whevt_. Matches the X-Postproxy-Delivery header.
  - `object` 'event', required: Always "event".
  - `type` string, required: Event type (e.g. platform_post.published). Matches the X-Postproxy-Event header.
  - `created_at` string, required: ISO 8601 timestamp of when the event was generated.
  - `data` object, required: Container for the event-specific resource.
    - `object` object: Attachment payload shape.
      - `id` string: Attachment id.
      - `post_id` string: Parent post id.
      - `content_type` string: MIME type of the attachment.
      - `status` 'failed': Always failed for this event.
      - `error_message` string: Human-readable error description.

## Acknowledgement `200`

Acknowledged

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)