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

post.approval.approved

Fired when an approver grants approval for a post

SENDpost.approval.approved
Message
application/json
typestring

The event type (e.g. post.approval.approved).

dataobject

Event-specific payload for this webhook.

Show properties
approvalobject

The approval that was granted.

Show properties
idstring

Approval ID.

isBlockingboolean

Whether this approval blocked publishing until granted.

messagestring

Optional message attached to the approval request.

dueDatestring<date-time>

ISO 8601 due date for the approval, if set.

createdAtstring<date-time>

ISO 8601 timestamp when the approval was created.

statusstring

Always Approved for this event.

approvedAtstring<date-time>

ISO 8601 timestamp when the approver granted approval.

approvedByUser

User who approved. 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.

requestedByUser

User who originally requested approval. 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.

postPostSummary

Post that was approved. Contains id, title, and url.

Show properties
idstring<uuid>

Post ID.

titlestring

Post title.

urlstring<uri>

Ordinal post URL.

campaignCampaign

Campaign the post belongs to, if any. Contains id, name, startDate, and endDate.

Show properties
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.

workspaceWorkspace

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

Show properties
idstring<uuid>

Workspace ID.

slugstring

Workspace slug.

namestring

Workspace name.

createdAtstring<date-time>

ISO 8601 timestamp when the webhook event was created.

Message
{
  "type": "post.approval.approved",
  "data": {
    "approval": {
      "id": "550e8400-e29b-41d4-a716-446655440700",
      "isBlocking": true,
      "message": "Please review before we publish.",
      "dueDate": "2025-02-28T17:00:00.000Z",
      "createdAt": "2025-02-26T14:00:00.000Z",
      "status": "Approved",
      "approvedAt": "2025-02-26T15:30:00.000Z",
      "approvedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440020",
        "firstName": "Alex",
        "lastName": "Rivera",
        "email": "alex@example.com"
      },
      "requestedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com"
      },
      "post": {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "title": "Q4 Product Launch Announcement",
        "url": "https://app.tryordinal.com/acme/posts/550e8400-e29b-41d4-a716-446655440001"
      },
      "campaign": {
        "id": "550e8400-e29b-41d4-a716-446655440003",
        "name": "Launch 2025",
        "startDate": "2025-01-01",
        "endDate": "2025-12-31"
      },
      "workspace": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "slug": "acme",
        "name": "Acme Inc"
      }
    }
  },
  "createdAt": "2025-02-26T15:30:00.000Z"
}