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

# platform_post.failed

`POST platform_post.failed` (webhook)

A post failed to publish to a platform.

## Payload

- WebhookEventPlatformPost: 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: Platform Post payload shape. The status and error fields reflect the outcome.
      - `id` string: Platform post id.
      - `post_id` string: Parent post id.
      - `platform` string: Network name.
      - `profile_id` string: Profile id.
      - `profile_name` string: Profile display name.
      - `status` 'published' | 'failed' | 'failed_waiting_for_retry'
      - `error` string, nullable: Error summary (null on success).
      - `error_details` PlatformErrorDetails, nullable: Structured platform error (omitted when no platform error info is available).
        - `platform_error_code` string, nullable: Error code returned by the platform API
        - `platform_error_subcode` string, nullable: Error subcode returned by the platform API
        - `platform_error_message` string, nullable: Error message returned by the platform API
        - `postproxy_note` string, nullable: Additional context from Postproxy about the error
      - `platform_id` string, nullable: External post ID on the platform (null until published).

## 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)