PostDestination

One platform/account target of a post

destination_idstring<uuid>required

idstring<uuid>deprecated

Deprecated alias of destination_id

account_idinteger | nullnullable

account_namestring | nullnullable

Present on getPost, createPost and results responses (not in listPosts)

account_avatar_urlstring | nullnullable

Present on createPost response only

platformstringrequired

destination_statusstringrequired

Lifecycle of THIS destination. A successful publish is done — there is no published value at the destination level (that name belongs to the post-level status vocabulary, which is a different taxonomy). In flight: preparing, uploading, publishing, verifying. Waiting: queued, retry_scheduled. Terminal: done, failed.

Possible values: [queued, preparing, uploading, publishing, verifying, retry_scheduled, done, failed, draft]

statusstringdeprecated

Deprecated alias of destination_status

scheduled_forstring,null<date-time>nullable

When THIS destination fires (the scheduler uses this, not the post-level value)

published_atstring,null<date-time>nullable

platform_post_idstring | nullnullable

platform_post_urlstring | nullnullable

Present on createPost and results responses after a successful publish

error

Last error (string or structured object), null when none

attemptsinteger

next_retry_atstring,null<date-time>nullable

metrics DestinationMetrics (object,null)

Engagement metrics fetched from the platform (null until first fetch; only some platforms have metric fetchers)

viewsinteger | nullnullable

likesinteger | nullnullable

commentsinteger | nullnullable

sharesinteger | nullnullable

impressionsinteger | nullnullable

savesinteger | nullnullable

clicksinteger | nullnullable

fetched_atstring,null<date-time>nullable

PostDestination

{
  "destination_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "account_id": 0,
  "account_name": "string",
  "account_avatar_url": "string",
  "platform": "string",
  "destination_status": "queued",
  "scheduled_for": "2024-07-29T15:51:28.071Z",
  "published_at": "2024-07-29T15:51:28.071Z",
  "platform_post_id": "string",
  "platform_post_url": "string",
  "attempts": 0,
  "next_retry_at": "2024-07-29T15:51:28.071Z",
  "metrics": "Unknown Type: object,null"
}