GET/v1/posts

listPosts

List posts. Lists the organization's posts, newest first, with cursor pagination. Each post carries its per-channel variants and latest delivery outcomes.

Required scope:posts:read

Parameters

limitquery · integeroptional

Page size (1–100).

afterquery · stringoptional

Opaque cursor from a previous page's `next_cursor`.

statusquery · "draft" | "scheduled" | "publishing" | "published" | "failed" | "needs_approval"optional

Filter by lifecycle state.

Responses

200PostList

One page of posts.

400invalid_requestvalidation_failed
401authentication_requiredinvalid_api_key
403insufficient_scopefeature_not_enabled
429rate_limitedquota_exhausted
500internal_error

Errors are RFC 9457 problem+json with a stable code and a request_id — each code above links to its own page.

Example

curl https://app.usepostify.com/v1/posts \
  -H "Authorization: Bearer postify_live_XXXXXXXXXXXXXXXX"