Followed Accounts

Track a new Instagram or TikTok account for the caller.

<br/>Canonical create endpoint for the Followed Accounts page (Phase 2B,<br/>2026-05-25). Body shape: {platform, handle}. Real profile / follower<br/>enrichment is deferred to a background job and noted as a Phase 2B<br/>follow-up; the row is created with display_name = handle and<br/>follower_count = null until the enrichment worker runs.

post/api/v1/followed-accounts

Request

  • Base URL: https://api.avatarfactory.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.avatarfactory.io/api/v1/followed-accounts
  • Auth: one of:
    • API key in cookie session
    • HTTP bearer

Request body

handlestring
platformstring

Response

Created

display_namestring nullable
follower_countinteger nullable
handlestring required
idinteger required
is_globalboolean
is_sharedboolean
last_synced_atstring nullable
platformstring required
profile_picture_urlstring nullable
reels_indexedinteger nullable

Changes

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