Accounts

Manage the Instagram, Threads, TikTok, and X accounts connected to a workspace. See Connecting Accounts for the full OAuth flow walkthrough.

List connected accounts

GET/v1/accounts

Query parameters

Param	Type	Description
platform	string	Filter to one platform.
status	string	`active`, `expired`, or `revoked`.
sandbox	boolean	Restrict to sandbox-created or live-connected accounts.

curl https://api.omnipost.dev/v1/accounts \
  -H "Authorization: Bearer $OMNIPOST_API_KEY"

{
  "data": [
    {
      "id": "acct_ig_5f8b2c9a1d7e4f30",
      "platform": "instagram",
      "username": "yourbrand",
      "status": "active",
      "connected_at": "2026-07-14T09:12:00Z"
    },
    {
      "id": "acct_tt_9c1a7e2b8f4d4056",
      "platform": "tiktok",
      "username": "yourbrand_official",
      "status": "expired",
      "connected_at": "2026-06-02T11:40:22Z"
    }
  ]
}

Get a connect URL

POST/v1/accounts/:platform/connect

:platform is one of instagram, threads, tiktok, x.

Body parameters

Field	Type	Required	Description
redirect_url	string	No	Where to send the end user after the connect flow finishes. Defaults to a generic OmniPost confirmation page.

curl -X POST https://api.omnipost.dev/v1/accounts/instagram/connect \
  -H "Authorization: Bearer $OMNIPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "redirect_url": "https://yourapp.com/settings/social" }'

{ "url": "https://connect.omnipost.dev/oauth/instagram/start?session=cs_7f2a1b9c8e4d4f2a" }

Disconnect an account

DELETE/v1/accounts/:id

curl -X DELETE https://api.omnipost.dev/v1/accounts/acct_ig_5f8b2c9a1d7e4f30 \
  -H "Authorization: Bearer $OMNIPOST_API_KEY"

204 No Content on success. Returns 404 not_found if the account doesn't belong to this workspace.