Preview a US TikTok account order from abroad

For an app, SaaS team or agency outside the United States, the first decision is the market you want to serve. The account's target country and your team's location are different fields. This guide evaluates one US TikTok account without buying video slots or adding warming options. TokPortal handles an ordered account's lifecycle; a US target does not guarantee views, reach or immunity from platform restrictions.

Start on the web

Read the US launch guide for teams abroad to prepare your brand, use case and budget. Then create your TokPortal account, or open the order form if already signed in. Select the available US market, TikTok and the account-only option, and review the current price and terms before confirming. You do not need an API key, n8n or MCP for this web path.

The technical preview below is useful when you want to evaluate the same request for a workflow. Prefer a visual import? Use the manual n8n preview.

1. Read available markets and current costs

Use an existing authorized API key from the Developer Portal, stored locally as TOKPORTAL_API_KEY. The reads require read access. The simulated creation also requires write access or full access; test is an environment label, not sandbox enforcement.

curl --fail-with-body https://app.tokportal.com/api/ext/countries \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

curl --fail-with-body https://app.tokportal.com/api/ext/credit-costs \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

Proceed only if the new-account list data contains USA. That is the canonical country code; US is an accepted alias. videos_only_countries lists markets for existing-account video orders and does not establish new-account availability. If USA is unavailable, stop instead of substituting another market. Availability is checked again by the API during the preview.

Review the effective pricing and recurring-account terms in GET /credit-costs. Do not hardcode an account price from an old example: the simulation returns the amount for your workspace and request.

2. Simulate one account-only order

curl --fail-with-body -i -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "X-TokPortal-Dry-Run: true" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_only",
    "platform": "tiktok",
    "country": "USA",
    "title": "US launch preview",
    "wants_advanced_warming": false
  }'

The fixed X-TokPortal-Dry-Run: true header makes this a simulation. Check the response before continuing:

• Response header X-TokPortal-Dry-Run: true.
• Success body dry_run: true, credits_charged: 0 and the numeric credits_would_charge quote.
• data.bundle_id beginning with 00000000-0000-4000-8000-. This ID is synthetic; no account order exists.

On an error, the response header is the simulation marker; the body can contain only the normal error. Stop on 401, 403, unavailable country or validation errors. Do not remove the header or retry as a live call. This preview does not create an order, debit credits, assign a manager or start publication.

3. Decide whether to place a separate order

Record the target market, requested account type and quoted credits. The quote describes the current request; it is not a price reservation, a delivered account, or proof that a later request will succeed unchanged.

If you decide to buy, open the web order form, review the current total and terms, then confirm your real order there. Real bundle creation charges credits immediately, before profile setup or publication. Never pass a synthetic ID into a live workflow.

After a real order exists, use Account Configuration and the app to prepare the brand profile. Once an account has actually been delivered, preview one MP4 configuration before introducing an upload or publishing automation. The Create Bundle reference covers the separate live API contract if you later choose an integration.