post.published

Fired when a post is successfully published to a social channel

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

PropType

typestring

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

Typestring

dataobject

Event-specific payload for this webhook.

Typeobject

data.postobject

The published post.

Typeobject

data.post.idstring

Post ID.

Typestring

data.post.titlestring

Post title.

Typestring

data.post.channelstring

Channel where the post was published (e.g. LinkedIn, Twitter).

Typestring

data.post.campaign?object | null

Campaign if the post is assigned to one. Contains id, name, startDate, and endDate.

Typeobject | null

data.post.urlstring

Ordinal post URL.

Typestring

data.post.postUrl?string | null

Published URL on the social platform.

Typestring | null

data.post.profileobject

Profile that published the post. Contains id, name, and detail.

Typeobject

data.post.workspaceobject

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

Typeobject

data.post.publishedByobject

User who triggered the publish. Contains id, firstName, lastName, and email.

Typeobject

data.post.publishedAtstring

ISO 8601 timestamp when the post was published.

Typestring

createdAtstring

ISO 8601 timestamp when the webhook event was created.

Typestring

{
  "type": "post.published",
  "data": {
    "post": {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "title": "Q4 Product Launch Announcement",
      "channel": "LinkedIn",
      "campaign": {
        "id": "550e8400-e29b-41d4-a716-446655440003",
        "name": "Launch 2025",
        "startDate": "2025-01-01",
        "endDate": "2025-12-31"
      },
      "url": "https://app.tryordinal.com/acme/posts/550e8400-e29b-41d4-a716-446655440001",
      "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7123456789012345678",
      "profile": {
        "id": "550e8400-e29b-41d4-a716-446655440002",
        "name": "Acme Inc",
        "detail": "acme-inc"
      },
      "workspace": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "slug": "acme",
        "name": "Acme Inc"
      },
      "publishedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com"
      },
      "publishedAt": "2025-02-26T14:30:00.000Z"
    }
  },
  "createdAt": "2025-02-26T14:30:00.000Z"
}