Order a US TikTok Workflow with TokPortal API

If your team is outside the United States, you can still create a TokPortal bundle with country: "US" or country: "USA" and platform: "tiktok". TokPortal then handles the order lifecycle for that target country.

This is an operational workflow, not a guarantee of reach, views, or immunity from platform restrictions. TikTok distribution and account health depend on content, timing, platform systems, and account state.

1. Create a US TikTok bundle

curl -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "US",
    "title": "US TikTok launch",
    "videos_quantity": 5,
    "wants_niche_warming": true,
    "niche_warming_instructions": "Tech product demos and founder-led content.",
    "external_ref": "us-tiktok-launch"
  }'

The server calculates credits and returns credits_charged, credits_remaining, and cost_breakdown.

Reference: Create Bundle

2. Configure the account

curl -X PUT https://app.tokportal.com/api/ext/bundles/bnd_abc123/account \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "mybrand_us",
    "visible_name": "My Brand",
    "biography": "New product videos.",
    "profile_picture_url": "https://cdn.example.com/mybrand/profile.jpg",
    "niche_warming_instructions": "Engage with tech and startup content."
  }'

Reference: Account Configuration

3. Configure content

curl -X PUT https://app.tokportal.com/api/ext/bundles/bnd_abc123/videos/1 \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "video_type": "video",
    "description": "What we built this week #startup #tech",
    "target_publish_date": "2026-06-05",
    "video_url": "https://cdn.example.com/videos/demo-01.mp4",
    "tiktok_sound_url": "https://www.tiktok.com/music/example-sound-123456789",
    "external_ref": "demo-01"
  }'

target_publish_date must respect the lead-time rules documented in Configure Videos. New accounts require more lead time than existing accounts.

4. Publish

curl -X POST https://app.tokportal.com/api/ext/bundles/bnd_abc123/publish \
  -H "X-API-Key: sk_your_key_here"

If publishing fails, check readiness:

curl -X GET https://app.tokportal.com/api/ext/bundles/bnd_abc123/publish-readiness \
  -H "X-API-Key: sk_your_key_here"

Reference: Publish & Unpublish

Scaling beyond one US account

Use Create Bulk to create multiple bundles in the same country:

curl -X POST https://app.tokportal.com/api/ext/bundles/bulk \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok"],
    "country": "US",
    "accounts_count": 10,
    "upload_accounts_count": 4,
    "videos_per_account": 8,
    "wants_niche_warming": true,
    "niche_warming_instructions": "Consumer tech and product demo content.",
    "external_ref": "us-tiktok-bulk"
  }'

To run the same workflow in other countries, first call:

curl -X GET https://app.tokportal.com/api/ext/countries \
  -H "X-API-Key: sk_your_key_here"

Then loop over the enabled countries and send one bulk request per country.

Track performance

After the account is delivered and posts are live:

curl -X GET https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics \
  -H "X-API-Key: sk_your_key_here"

For post-level metrics:

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics/videos?sort_by=views&sort_order=desc" \
  -H "X-API-Key: sk_your_key_here"

Reference: Analytics

Related guides: n8n, Bulk TikTok Account Creation, Python Quickstart.