Create TikTok accounts with Goose

Q: How long does delivery take?

Typically 24–72 hours from `publish_bundle` to `account.finalized`, depending on the country's manager pool and whether warming was ordered. Poll `get_bundle` or subscribe to `account.finalized`.

Q: Can I pick the exact username?

You request it in `configure_bundle_account`. If it is unavailable the manager flags it (`account.pending_corrections`) and you send a new one with the same tool; the agent can propose variants automatically.

Q: Is there a limit on how many accounts I can create?

`create_bundles_bulk` accepts up to 100 accounts per call and you can call it repeatedly; the practical limit is manager capacity in the chosen country, which the API reports through delivery times rather than a hard cap.

To create TikTok accounts from Goose, connect the TokPortal MCP server and ask for a bundle: create_bundle opens a work order for a new account in a given country, configure_bundle_account sets the handle and profile, publish_bundle hands it to a human account manager in that country, and list_accounts returns the delivered account a few days later. There is no official TikTok endpoint that creates accounts at all — the Login Kit / Content Posting API only let a user who already owns an account authorize your app — so this job is only possible with human-operated infrastructure like TokPortal.

Connect TokPortal to Goose

Goose is an autonomous agent: Block's open-source local agent; remote MCP servers are added as extensions (Streaming HTTP) or via a goose:// deeplink.

Add to Goose All hosts

Click Add to Goose, or run goose configure → Add Extension → Remote Extension (Streaming HTTP) with URL https://app.tokportal.com/api/ext/mcp. Deeplink:

goose://extension?type=streamable_http&url=https%3A%2F%2Fapp.tokportal.com%2Fapi%2Fext%2Fmcp&id=tokportal&name=TokPortal

Snippet status: verified against Goose's documentation (source).

Once connected, sanity-check the setup with a read-only call: "What is my TokPortal credit balance?" should trigger tokportal_get_credit_balance. GET requests and dry-run writes do not spend credits.

Try the workflow without spending

For this trial, use the remote MCP endpoint https://app.tokportal.com/api/ext/mcp, local tokportal-mcp 1.15.1 or later, or the REST API. Upgrade and restart an older local server first. Version 1.15.0 does not forward the dry-run header; do not use its write tools for a simulation. If you cannot verify the installed local version, use the remote endpoint or REST.

Use the sandbox for the first attempt. MCP write tools accept dry_run: true as a top-level argument, beside body; REST writes accept the X-TokPortal-Dry-Run: true header. Keep your usual authentication and scopes. Each simulated write validates the request and returns credits_would_charge with credits_charged: 0. Nothing is created or published.

Simulated IDs start with 00000000-0000-4000-8000-. Use them only in later dry-run writes. GET requests read real data, so skip publish-readiness checks and polling for synthetic IDs. Simulations have no cross-call memory and upload URLs are placeholders: do not upload files to them.

To run for real, review the returned price and confirm before the first live write. Bundle creation charges credits immediately; publishing hands the order to a manager. Repeat creation without dry-run mode and use the new real IDs for configuration and publishing. A synthetic ID cannot be reused in a live request.

How it works

A TokPortal bundle is the unit of work. For a new account you create it with bundle_type: "account_only" (just the account) or "account_and_videos" (account plus a schedule of videos_quantity posts). The country field decides which pool of managers gets the order: a US bundle is created and warmed by a manager physically in the United States, on a US SIM and residential connection, so the account is native to that region from day one. Call list_countries first — it returns the countries currently open for new-account creation and, separately, the ones open for videos_only orders on existing accounts.

Once the bundle exists you configure the account: username (1–24 chars, letters/digits/_/., no trailing dot), visible_name (≤30), biography (≤80 on TikTok), an optional profile_picture_url and link_in_bio. Then publish_bundle. The account setup and selected slots are charged when the bundle is created. Simulate creation with dry_run: true first to see the exact credits_would_charge without spending. The manager creates the account, warms it and finalizes it; the account then appears in list_accounts with status, country, profile_url and a ban_appeal block that stays null while the account is healthy. Credentials are never returned by ordinary tools — the account is managed, which is exactly what keeps it alive; reveal_account_credentials exists but detaches the account from management and needs a two-step confirmation.

Add wants_advanced_warming: true and 3–30 advanced_warming_terms (multiples of 3) if you want the manager to warm the account on niche searches with a recorded, verified session per term before you post — see Warm accounts.

Run it from Goose

Goose runs autonomously, so the prompt below keeps every write in dry-run mode. Let it validate the requests and report the prices, then confirm before the first real write, including create_bundle.

Tool sequence

tokportal_list_countries — Confirm the target country is open for new-account creation (returns data[] for new accounts and videos_only_countries[]).
tokportal_get_credit_costs — Read the live account-setup price and any contract allowance before quoting the user.
tokportal_create_bundle — bundle_type: account_only (or account_and_videos with videos_quantity), platform: tiktok, country: US; optional external_ref for de-duplication.
tokportal_configure_bundle_account — Set username, visible_name, biography, profile_picture_url, link_in_bio (PUT, can be called again before publishing).
tokportal_get_bundle_publish_readiness — Returns what is still missing (account fields, credits) so the agent fixes it instead of hitting a 400.
tokportal_publish_bundle — Sends the order to a manager in the chosen country. Bundle creation already charged the credits.
tokportal_get_bundle — Poll account_status (configured → published → in_review → finalized) or subscribe to account.finalized with create_webhook_endpoint.
tokportal_list_accounts — Filter platform=tiktok&country=US to retrieve the delivered account and its profile_url.

Prompt to paste

Evaluate this workflow in the TokPortal sandbox only.
Use the remote MCP endpoint https://app.tokportal.com/api/ext/mcp or local tokportal-mcp 1.15.1 or later for write tools.
Verify the installed local version before using its write tools. Version 1.15.0 is unsafe for simulations.
If the local version is older or unknown, use the remote endpoint or authenticated REST
requests with X-TokPortal-Dry-Run: true instead.
For every non-GET MCP tool call, set dry_run: true as a top-level boolean beside body.
For every REST write in a workflow, send the X-TokPortal-Dry-Run: true header.
Use normal read tools for existing real objects. Do not GET or poll synthetic IDs,
and do not upload files to simulated upload URLs. Simulated objects have no cross-call memory.
Show credits_would_charge and verify credits_charged is 0 for each simulated write.
Do not execute any live write. Ask for my explicit GO before the first real write,
including bundle creation, which charges immediately. After GO, repeat creation
without dry_run and use the new real IDs; never reuse synthetic IDs in live requests.

Use the TokPortal MCP tools. Call list_countries and get_credit_costs first.
Then create a TikTok bundle in the US (bundle_type account_only, title "US launch #1"),
configure the account as @acme_kitchen / "Acme Kitchen" / bio "Recipes in 30s",
simulate publish_bundle and show me the returned validation and credits_would_charge.

Enable the TokPortal extension in the session, paste the prompt; Goose runs tools autonomously, so ask it explicitly to stop before write tools.

REST equivalent (write requests below are simulations; GET requests read existing real data)

# 1. Create the work order
curl -X POST -H "X-TokPortal-Dry-Run: true" https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: sk_..." -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"bundle_type":"account_only","platform":"tiktok","country":"US","title":"US launch #1"}'

# 2. Simulate the profile (BUNDLE_ID from step 1: data.bundle_id)
curl -X PUT -H "X-TokPortal-Dry-Run: true" https://app.tokportal.com/api/ext/bundles/BUNDLE_ID/account \
  -H "X-API-Key: sk_..." -H "Content-Type: application/json" \
  -d '{"username":"acme_kitchen","visible_name":"Acme Kitchen","biography":"Recipes in 30s","link_in_bio":"https://acme.example"}'

# 3. Simulate publishing; the GET below lists only existing real accounts
curl -X POST -H "X-TokPortal-Dry-Run: true" https://app.tokportal.com/api/ext/bundles/BUNDLE_ID/publish -H "X-API-Key: sk_..."
curl "https://app.tokportal.com/api/ext/accounts?platform=tiktok&country=US" -H "X-API-Key: sk_..."

Key parameters

Parameter	Values	Notes
`bundle_type`	account_only · account_and_videos · videos_only	account_only for a bare account; account_and_videos to ship posts with it.
`platform`	tiktok · instagram (default tiktok)	One platform per bundle; use create_bundles_bulk for several.
`country`	ISO code, e.g. US, GB, FR, DE, BR	Required unless videos_only. Check list_countries — availability changes.
`username`	1–24 chars, [a-zA-Z0-9_.]	Cannot end with a dot; the manager reports if it is taken (account.pending_corrections).
`biography`	≤80 chars on TikTok	120 on Instagram.
`wants_advanced_warming / advanced_warming_terms`	boolean · 3–30 terms (multiple of 3)	5 credits per term, min 15; TikTok and Instagram only.
`external_ref`	≤200 chars	Duplicate-detection aid (DUPLICATE_ACCOUNT_BUNDLE); not an idempotency key.

Full schemas: OpenAPI reference · openapi.json.

Example configurations

Bare US account

{"bundle_type":"account_only","platform":"tiktok","country":"US","title":"US #1"}

UK account with 12 posts and warming

{"bundle_type":"account_and_videos","platform":"tiktok","country":"GB","videos_quantity":12,
 "wants_advanced_warming":true,
 "advanced_warming_terms":["air fryer recipes","meal prep uk","budget dinners"]}

Ten accounts at once (bulk)

{"platforms":["tiktok"],"country":"US","accounts_count":10,"videos_per_account":0,"external_ref":"batch-2026-08"}

Credits

Standard account setup is 32 credits per TikTok account, plus 2 credits per video slot and 5 credits per Advanced Warming target (minimum 3 targets). Credits are charged on real bundle creation. A dry run charges 0 and returns credits_would_charge. Always read get_credit_costs — contract allowances override the standard rate. Details on Credits & Pricing.

Why not the official API

There is no account-creation endpoint in the TikTok for Developers API: Login Kit authorizes an existing user, and the Content Posting API posts on that user's behalf after they approve the video.publish scope. Creating accounts programmatically is therefore not a rate-limit question but an impossibility with first-party tools; TokPortal replaces it with human managers who create the account in the target country and keep it operated.

As of August 2026 the first-party routes look like this. TikTok's Content Posting API (Direct Post) requires each account owner to authorize your app with the video.publish scope, limits every user access token to 6 requests per minute, keeps all posts from unaudited apps in private viewing mode until TikTok audits the app, and enforces an unpublished daily post cap per user (spam_risk_too_many_posts) that integrators commonly report at roughly 15–25 posts per account per day. Meta's Instagram Content Publishing API allows 100 API-published posts per professional account in a 24-hour moving window and only for accounts you own and connect via OAuth. Neither creates accounts, warms them, or reports third-party bans. TokPortal is human-operated infrastructure: accounts created and run by managers in the target country, one X-API-Key for all of them, dated slots (max 3 per day per bundle) instead of per-account tokens.

Sources: TikTok Content Posting API – Direct Post, TikTok Content Posting API – Get started, Instagram Platform – Content Publishing.

Create TikTok accounts with Goose

Connect TokPortal to Goose

Try the workflow without spending

How it works

Run it from Goose

Key parameters

Example configurations

Credits

Why not the official API

FAQ

How long does delivery take?

Can I pick the exact username?

Do I get the password?

Is there a limit on how many accounts I can create?

Also works with

Other jobs with Goose