Social Accounts

Retrieve a social account

One connected account by id. Same shape as a row in the list, so anything holding an acc_… can ask about it directly instead of paging the list and filtering.

get/v1/social-accounts/{id}

Request

  • Base URL: https://api.postlake.dev
  • URL: https://api.postlake.dev/v1/social-accounts/{id}
  • Auth: bearerAuth (a scheme the document does not define)

Path parameters

idstring required

Response

Success

idstring required
platform'bluesky' | 'threads' | 'x' | 'linkedin' | 'instagram' | 'tiktok' | 'facebook' | 'youtube' | 'pinterest' required
handlestring required
profileIdstring nullable required
statusstring required
avatarUrlstring nullable
connectVariantstring

Which door this account was connected through, for networks that have more than one. Instagram is the case: instagram means Instagram Login, facebook means it was connected through a Facebook Page. The two reach genuinely different feature sets, so this decides what the account can do. Absent on networks with a single way in.

accountType'BUSINESS' | 'MEDIA_CREATOR' | 'PERSONAL' nullable

Instagram account type when known. Stories support both login routes, subject to Meta account eligibility. Facebook Login Stories require a Business account. Null means the type is unknown; Meta enforces eligibility during publishing.

requiresstring nullable

What this network needs before it will publish, in one sentence (media requirements, title and caption limits). Read it before composing: TikTok, Instagram, YouTube and Pinterest all refuse text-only posts. Null when the network accepts anything.

Changes

No recorded changes to this operation across all 1 revision of this API.