Publications — Wahlu API Docs

Publications track the history of post deliveries to social media platforms. Each time a post is published, a publication record is created with the result.

Required scope: publications:read

List publications

GET/v1/brands/:brand_id/publications

Returns publication history for a brand, ordered by most recent first.

Query parameters

Parameter	Type	Description
`page`	integer	Page number. Defaults to 1.
`limit`	integer	Items per page. Defaults to 50, max 100.
`sort_by`	string	Field to sort by. One of: created_at, updated_at. Defaults to created_at.
`sort_dir`	string	Sort direction. One of: asc, desc. Defaults to desc.

curl

curl "https://api.wahlu.com/v1/brands/brand_abc123/publications?limit=10" \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "pub_abc123",
      "platform": "instagram",
      "post_id": "post_xyz789",
      "post_name": "Product Launch Announcement",
      "post_type": "post",
      "media_type": "image",
      "status": "published",
      "source": "calendar",
      "failure_reason": null,
      "integration_id": "int_instagram_123",
      "publish_id": "17920345678901234",
      "published_at": "2026-02-12T09:00:00Z",
      "created_at": "2026-02-12T09:00:00Z",
      "updated_at": "2026-02-12T09:00:01Z"
    },
    {
      "id": "pub_def456",
      "platform": "linkedin",
      "post_id": "post_xyz789",
      "post_name": "Product Launch Announcement",
      "post_type": "post",
      "media_type": null,
      "status": "published",
      "source": "calendar",
      "failure_reason": null,
      "integration_id": "int_linkedin_456",
      "publish_id": "urn:li:share:7890123456789",
      "published_at": "2026-02-12T09:00:01Z",
      "created_at": "2026-02-12T09:00:01Z",
      "updated_at": "2026-02-12T09:00:02Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "has_more": false
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique publication identifier.
`platform`	string	Platform published to (instagram, tiktok, youtube, facebook, linkedin).
`post_id`	string	The post that was published.
`post_name`	string \| null	Name of the post at time of publishing.
`post_type`	string \| null	Post type (e.g. post, reel, story).
`media_type`	string \| null	Media type (e.g. image, video, carousel).
`status`	string	Publication status (processing, published, failed).
`source`	string \| null	How it was published (calendar or queue).
`failure_reason`	string \| null	Error message if status is failed.
`integration_id`	string	The integration used to publish.
`publish_id`	string \| null	Platform-specific post ID (e.g. Instagram media ID, LinkedIn share URN).
`published_at`	string	ISO 8601 timestamp when it was published.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.