Skip to main content

Account

idintegerrequired
uuidstring<uuid>required
namestringrequired
Example: My Instagram
usernamestringrequired
Example: myhandle
image(string | null)<uri>nullable
providerstringrequired

Network key. Known values: twitter, facebook_page, instagram, instagram_standalone, threads, linkedin, linkedin_page, tiktok, youtube, pinterest, gbp, bluesky, mastodon, pixelfed, telegram, discord, slack. New networks add new keys, so treat unknown values as valid.

Example: instagram
dataobjectrequired

Provider-specific metadata.

authorizedbooleanrequired
profile_url(string | null)<uri>nullable

Public URL of the account's profile on the network, when known.

publish_statusstring

Only present when the account is embedded in a post. Publishing state of this account for the post.

Possible values: [pending, publishing, published, failed]

published_partsinteger

Only present when the account is embedded in a post. How many parts (for example thread items or a first comment) are live on the network.

Possible values: >= 0

external_urlstring | nullnullable

Only present when the account is embedded in a post. URL of the published post on the network, null until it is live.

provider_post_idstring | nullnullable

Only present when the account is embedded in a post. The network's own ID of the published post (for example a LinkedIn share URN or a tweet ID), null until it is live.

errors object[]

Only present when the account is embedded in a post. Why publishing to this account failed. A raw network error is stored as two entries: a readable line ("<Network>: <message> (code <code>)") and an object {platform, code, message, raw} with the network's original response in raw. Other failures are a single readable string.

  • Array [
  • oneOf
    string
  • ]
  • created_atstringrequired

    UTC, formatted Y-m-d H:i:s.

    Example: 2026-10-11 09:30:00
    Account
    {
    "id": 0,
    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "My Instagram",
    "username": "myhandle",
    "image": "string",
    "provider": "instagram",
    "data": {},
    "authorized": true,
    "profile_url": "string",
    "publish_status": "pending",
    "published_parts": 0,
    "external_url": "string",
    "provider_post_id": "string",
    "errors": [
    "string",
    {
    "platform": "string",
    "code": "string",
    "message": "string"
    }
    ],
    "created_at": "2026-10-11 09:30:00"
    }