DocumentationAccounts

Accounts

Add a social media account once. Your agent can then use it. Each account gets its own browser profile, device fingerprint and proxy.

Connect methods

password: Username and password. Send the username, the password and, if the account uses an authenticator app, its secret. BuzzTake answers 2FA codes itself. Fields: username, password, totp_secret (optional).
cookies: Cookies. Import cookies from a browser where the account is already signed in: a JSON array or a Netscape cookie file. Field: cookies.
browser: Sign in yourself. Open a live browser and sign in as you always do. Or send the one-time sign-in link to the person who owns the account. No fields. Use the sign_in_url in the answer.

Add an account

POST/v1/workspaces/{workspace_id}/accounts

Body

{
  "platform": "x",
  "label": "Brand main",
  "instance": null,
  "connect": {
    "method": "password",
    "username": "acme_demo",
    "password": "your-password",
    "totp_secret": "JBSWY3DPEHPK3PXP"
  },
  "proxy": "http://user:pass@203.0.113.7:8000",
  "device": "linux"
}

Field	Rules
`platform`	Required. A platform id.
`label`	Optional, at most 80 characters. Default: the handle.
`instance`	Mastodon only: the server origin, such as `https://mastodon.social`. Else `null`.
`connect.method`	`password`, `cookies` or `browser`. See Connect methods.
`proxy`	Optional URL or `null`. Schemes: `http`, `https`, `socks5`, `ss`, `vless`, `vmess`, `trojan`, `hysteria2`. Without one, the account uses a datacenter address that platforms trust less.
`device`	`linux`, the default and only accepted value. Fixed for the life of the account.

201 Created (trimmed)

{
  "account": { "id": "0199a1b2-...", "status": "connecting" },
  "action": { "id": "0199c3d4-...", "type": "connect", "status": "queued" },
  "sign_in_url": "https://buzztake.com/connect/bts_..."
}

sign_in_url is present for method: browser and when a challenge appears.

Cookies

A Netscape cookie file goes in cookies as one string.

Body

{
  "platform": "instagram",
  "connect": {
    "method": "cookies",
    "cookies": [
      { "name": "sessionid", "value": "...", "domain": ".instagram.com", "path": "/" }
    ]
  }
}

Credentials

BuzzTake stores passwords and 2FA secrets encrypted and never returns them. The account shows only has_credentials. With stored credentials, BuzzTake signs in again when cookies expire.

One link opens a live browser for one account.
It works for 30 minutes, without a BuzzTake login.
An agent can send it to the person who owns the account.

Account object

Account

{
  "id": "0199a1b2-...",
  "workspace_id": "0199...",
  "platform": "x",
  "label": "Brand main",
  "handle": "acme_demo",
  "display_name": "Acme Demo",
  "avatar_url": null,
  "status": "active",
  "status_reason": null,
  "device": "linux",
  "proxy": { "configured": true, "scheme": "http", "host": "203.0.113.7" },
  "connect_methods": ["password", "cookies", "browser"],
  "has_credentials": true,
  "actions": ["post", "reply", "quote", "..."],
  "last_checked_at": "2026-10-13T20:00:00Z",
  "created_at": "2026-10-13T19:00:00Z"
}

Statuses

connecting: BuzzTake is signing in.
active: Signed in and ready.
needs_input: A sign-in challenge waits for an answer.
signed_out: Cookies expired and no stored credentials could sign in again.
blocked: The platform shows a checkpoint on the account.
error: Something failed that BuzzTake could not classify.

Routes

Route	Does
`GET /v1/workspaces/{ws}/accounts`	List, newest first. Filters: `?platform=`, `&status=`.
`GET /v1/accounts/{id}`	One account.
`PATCH /v1/accounts/{id}`	Change `label`, `proxy` or `credentials` (`{ username, password, totp_secret }`, or `null` to forget).
`DELETE /v1/accounts/{id}`	Delete the account and its browser profile data.
`POST /v1/accounts/{id}/connect`	Sign in again with the same `connect` body. Returns an action. 25 credits per attempt.
`POST /v1/accounts/{id}/check`	Report whether the account is still signed in. Returns an action. 1 credit.
`POST /v1/accounts/{id}/sign-in-links`	A new `sign_in_url`, valid for 30 minutes.
`POST /v1/accounts/{id}/live`	Start a live browser: `{ session_id, websocket_url }`. 2 credits per started minute.

Platforms

Platform	Id	Note
X	`x`
Instagram	`instagram`
Facebook	`facebook`
LinkedIn	`linkedin`
TikTok	`tiktok`
Threads	`threads`
Bluesky	`bluesky`
Reddit	`reddit`
YouTube	`youtube`	YouTube signs in with the Google account that owns the channel.
Pinterest	`pinterest`
Mastodon	`mastodon`	Send the server origin in `instance`, such as https://mastodon.social.
Telegram	`telegram`	Telegram signs in with a phone number and a login code. The code arrives as a challenge you answer.