Preview a US TikTok account order with n8n
Check available markets and preview one US TikTok account order in n8n. Get your workspace's quoted credits without creating an account, buying slots, or publishing.
Preview a US TikTok account order with n8n
An app, SaaS team or agency outside the US can evaluate one account for its US launch before placing an order. This recipe reads available markets, reads your workspace's costs, simulates an account_only order and stops at the quote. It does not add video slots or warming options.
You can also use the web app. Start with the US launch guide for teams abroad, create a TokPortal account, or open the order form if you already have one. The web path needs neither n8n nor MCP. Review the current terms and amount before confirming an order; a target country does not guarantee views or reach.
Import the manual preview
Download the n8n preview workflow, then choose Import from File in n8n. It uses built-in HTTP Request and Code nodes, so the TokPortal community node and an AI agent are not prerequisites.
Create or select an n8n Header Auth credential with header name X-API-Key and your TokPortal key as its value. Select that same credential in Read markets, Read workspace costs and Simulate one account. Keep the key in n8n Credentials, never in the workflow JSON. Keys are managed in the Developer Portal.
The key needs both read and write access, or full access: a simulated POST still passes the normal write-permission checks. An environment label such as test does not enable simulation. A read-only key can inspect markets and costs, but its preview can return 403; stop there and use an appropriately authorized key. Never remove the dry-run header to work around an error.
Press Execute workflow manually. The imported workflow is inactive and contains no schedule or webhook trigger.
| Step | What runs | What to inspect |
|---|---|---|
| Read markets | GET /countries | body.data lists markets for new accounts. videos_only_countries is a separate list for existing accounts. |
| Confirm US availability | Local Code node | Stops if USA is absent from body.data. It does not pick another country. |
| Read workspace costs | GET /credit-costs | Current workspace pricing and recurring-account terms. This is not a hardcoded price estimate. |
| Simulate one account | POST /bundles with the fixed header X-TokPortal-Dry-Run: true | One TikTok account_only order in USA, with no warming add-on. |
| Verify preview and show quote | Local Code node | Requires the response header, dry_run: true, credits_charged: 0, a numeric credits_would_charge, and a synthetic bundle ID. Stops after displaying the result. |
The response must contain data.bundle_id; it is not a top-level id. A synthetic ID starts with 00000000-0000-4000-8000- and represents nothing created. The quote is for the simulated request at that moment, not a reservation or a delivery confirmation. See Sandbox for the full contract.
Read the result before deciding to buy
credits_would_charge is your server-calculated quote, including any effective workspace allowance. credits_charged must be zero. The preview performs the API's normal validation and pricing but stops before writes: no order, credit debit, manager assignment, upload, publication or notification is created. Normal authentication and rate limits still apply.
The final Code node validates the response; the fixed request header is what makes the call a simulation. Keep it on every write. If the HTTP node returns an error, inspect its status and X-TokPortal-Dry-Run response header. Error bodies do not necessarily contain dry_run. Stop on authentication, permission, unavailable-market or validation errors; there is no fallback to a live request.
To order after reviewing the result, open the web order form. Select the account-only option, TikTok and the available US market, then review today's amount and terms before confirming. A real bundle creation charges credits immediately; publication is a later step. The preview workflow has no live switch and does not place the order for you. Never reuse a synthetic ID in a live request or another operational workflow.
For the same evaluation in a terminal, use the US account preview guide. For a video on an account already delivered, use MP4 configuration preview.
Reuse the existing operational templates later
The eight existing TokPortal n8n templates cover operational work after a purchase decision. They are not substitutes for this preview:
- Sheet rows to bundles creates and publishes real bundles, then writes back to Sheets.
- Faceless channel factory has a daily schedule and configures/publishes slots on an existing bundle.
- Video URL to upload and schedule receives a webhook, uploads media and enables
auto_publish. - Credits guard runs on a schedule and can send Slack messages. Its estimated runway is not the account-order quote returned by this simulation.
Keep those workflows inactive while reviewing their credentials, triggers and real actions. Choose one only when its specific operational work is wanted. The community-node guide documents those capabilities.