TokPortal API Docs<br>QuickstartSearch⌘KPortalOpenAPIllms-full.txt

Build your first TokPortal integration in 5 minutes.

Prerequisites

A TokPortal account at app.tokportal.com

Credits in your account (buy credits)

An API key (generate one)

Step 1: Generate an API Key

Go to the Developer Portal and click Generate . Copy your key — it starts with sk_ and is shown only once.

Step 2: Verify Your Key

curl https://app.tokportal.com/api/ext/me \<br>-H "X-API-Key: sk_your_key_here"

You should see your profile and credit balance.

Step 3: Create a Bundle

curl -X POST https://app.tokportal.com/api/ext/bundles \<br>-H "X-API-Key: sk_your_key_here" \<br>-H "Content-Type: application/json" \<br>-d '{<br>"bundle_type": "account_and_videos",<br>"platform": "tiktok",<br>"country": "USA",<br>"title": "My First Bundle",<br>"videos_quantity": 5<br>}'

This creates a TikTok account in the USA with 5 video slots. Cost: 35 credits (25 account + 5×2 videos).

Step 4: Configure the Account

curl -X PUT https://app.tokportal.com/api/ext/bundles/{bundle_id}/account \<br>-H "X-API-Key: sk_your_key_here" \<br>-H "Content-Type: application/json" \<br>-d '{<br>"username": "mybrand",<br>"visible_name": "My Brand Official",<br>"biography": "Fashion and lifestyle content"<br>}'

Step 5: Configure Videos

Upload a video first, then configure:

# Get a presigned upload URL<br>curl -X POST https://app.tokportal.com/api/ext/upload/video \<br>-H "X-API-Key: sk_your_key_here" \<br>-H "Content-Type: application/json" \<br>-d '{"filename": "video1.mp4", "bundle_id": "{bundle_id}"}'

# Upload the file (use the upload_url from the response)<br>curl -X PUT "{upload_url}" \<br>-H "Content-Type: video/mp4" \<br>--data-binary @video1.mp4

# Configure the video slot<br>curl -X PUT https://app.tokportal.com/api/ext/bundles/{bundle_id}/videos/1 \<br>-H "X-API-Key: sk_your_key_here" \<br>-H "Content-Type: application/json" \<br>-d '{<br>"video_type": "video",<br>"description": "Check out this trend! #fashion",<br>"target_publish_date": "2026-03-01",<br>"video_url": "{public_url}"<br>}'

Or use batch configuration to set up multiple videos at once, or CSV import to import from a spreadsheet.

Step 6: Publish

curl -X POST https://app.tokportal.com/api/ext/bundles/{bundle_id}/publish \<br>-H "X-API-Key: sk_your_key_here"

Your bundle is now live. An account manager will be assigned and start working on it.

Step 7: Track Progress

curl https://app.tokportal.com/api/ext/bundles/{bundle_id} \<br>-H "X-API-Key: sk_your_key_here"

Monitor the status field on the bundle, account, and each video.

What's Next?

Create Bulk bundles for large-scale campaigns

CSV Import for spreadsheet-based workflows

Analytics to track account performance

Accounts to manage delivered accounts and retrieve verification codes

On this page<br>PrerequisitesStep 1: Generate an API KeyStep 2: Verify Your KeyStep 3: Create a BundleStep 4: Configure the AccountStep 5: Configure VideosStep 6: PublishStep 7: Track ProgressWhat's Next?<br>Ask TokPortal AI...⌘J