Skip to content
Ordinal
Esc
↑↓navigate↵open⌘Jpreview

post.publish_failed

Fired when a post fails to publish

SENDpost.publish_failed
Message
application/json
typestring

The event type (e.g. post.publish_failed).

dataobject

Event-specific payload for this webhook.

Show properties
postobject

The post that failed to publish.

Show properties
idstring

Post ID.

titlestring

Post title.

channelstring

Channel where publish failed.

errorstring

Error message describing the failure.

campaignCampaign | null

Campaign if assigned. Contains id, name, startDate, and endDate.

Show properties
Any of:
Campaign
idstring<uuid>

Campaign ID.

namestring

Campaign name.

startDatestring<date-time>

Campaign start, as an ISO 8601 timestamp.

endDatestring<date-time>

Campaign end, as an ISO 8601 timestamp.

null
null
urlstring

Ordinal post URL.

profilePublishingProfile

Profile that attempted to publish. Contains id, name, and detail.

Show properties
idstring<uuid>

Profile ID.

namestring | null

Profile name. Can be null.

detailstring | null

Profile handle or vanity name. Can be null.

scheduledPublishAtstring<date-time>

ISO 8601 timestamp when publish was attempted.

workspaceWorkspace

Workspace the post belongs to. Contains id, slug, and name.

Show properties
idstring<uuid>

Workspace ID.

slugstring

Workspace slug.

namestring

Workspace name.

createdByUser

User who created the post. Contains id, firstName, lastName, and email.

Show properties
idstring<uuid>

User ID.

firstNamestring | null

First name. Can be null.

lastNamestring | null

Last name. Can be null.

emailstring<email>

Email address.

failedAtstring<date-time>

ISO 8601 timestamp when the publish failed.

createdAtstring<date-time>

ISO 8601 timestamp when the webhook event was created.

Message
{
  "type": "post.publish_failed",
  "data": {
    "post": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "title": "Q4 Product Launch Announcement",
      "channel": "LinkedIn",
      "error": "Token expired",
      "campaign": null,
      "url": "https://app.tryordinal.com/acme/posts/550e8400-e29b-41d4-a716-446655440001",
      "profile": {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "name": "Acme Inc",
        "detail": "acme-inc"
      },
      "scheduledPublishAt": "2025-03-01T14:00:00.000Z",
      "workspace": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "slug": "acme",
        "name": "Acme Inc"
      },
      "createdBy": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com"
      },
      "failedAt": "2025-03-01T14:00:05.000Z"
    }
  },
  "createdAt": "2025-03-01T14:00:05.000Z"
}