Source: https://developers.tokportal.com/use-cases/
Markdown: https://developers.tokportal.com/use-cases.md

# Use Cases & Integrations

These guides show realistic ways to use the public TokPortal API. They are implementation recipes, not separate products: no-code tools call the REST API through HTTP modules, AI tools use the published MCP server, and custom apps can use raw HTTP, the Node SDK, or the CLI.

Core references:

- [Authentication](https://developers.tokportal.com/authentication) - send `X-API-Key` on every API request
- [Create Bundle](https://developers.tokportal.com/create-bundle) - create account/video bundles
- [Create Bulk](https://developers.tokportal.com/create-bulk) - create multiple bundles for one country and one or more platforms
- [Configure Videos](https://developers.tokportal.com/configure-videos) - configure captions, dates, video URLs, carousels, and platform fields
- [Media Upload](https://developers.tokportal.com/media-upload) - direct upload, presigned upload, and URL-based media ingestion
- [Webhooks](https://developers.tokportal.com/webhooks) - receive lifecycle events
- [SDKs & CLI](https://developers.tokportal.com/sdks-cli) - public packages available today
- [MCP Server](https://developers.tokportal.com/mcp) - AI tool integration via `tokportal-mcp`

## No-Code Automation

TokPortal ships the `n8n-nodes-tokportal` community node. The first-run preview below uses built-in n8n HTTP nodes with `X-API-Key`; Zapier and Make can also use their HTTP modules.

| Guide                                                                                                                      | What you'll build                                                                   |
| -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| [Preview one US account with n8n](https://developers.tokportal.com/use-cases/no-code/n8n-us-account-preview)               | Manual markets → account-only simulation → quoted credits, with a web purchase path |
| [Validate an MP4 on a delivered account](https://developers.tokportal.com/use-cases/no-code/mp4-delivered-account-preview) | Simulate one existing slot configuration without upload or publication              |
| [n8n + TikTok Automation](https://developers.tokportal.com/use-cases/no-code/n8n-tiktok-automation)                        | HTTP workflow: create bundle, configure account/video, publish                      |
| [Zapier + Social Media](https://developers.tokportal.com/use-cases/no-code/zapier-social-media-automation)                 | Zapier webhooks flow from Sheets, Airtable, Dropbox, or a CMS                       |
| [Make + TikTok](https://developers.tokportal.com/use-cases/no-code/make-tiktok-automation)                                 | Visual scenario for one or more country-specific API calls                          |

## AI Agents

Use the published MCP server to expose generated TokPortal tools to MCP-compatible assistants.

| Guide                                                                                                    | What you'll build                                                   |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [OpenClaw AI Agent](https://developers.tokportal.com/use-cases/ai-agents/openclaw-tiktok-posting)        | Natural-language TokPortal workflow using the OpenClaw skill path   |
| [Cursor MCP Server](https://developers.tokportal.com/use-cases/ai-agents/cursor-mcp-tiktok)              | Create bundles and configure videos from Cursor via `tokportal-mcp` |
| [Claude Code + TokPortal](https://developers.tokportal.com/use-cases/ai-agents/claude-code-social-media) | MCP-powered campaign operations from Claude-compatible tools        |

## Platform Guides

Focused guides for common API surfaces.

| Guide                                                                                                                         | What you'll learn                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| [Create Instagram Accounts via API](https://developers.tokportal.com/use-cases/platform-guides/create-instagram-accounts-api) | Instagram account bundles, profile configuration, Reels, posts, and carousels          |
| [Post to US TikTok from Abroad](https://developers.tokportal.com/use-cases/platform-guides/post-us-tiktok-from-abroad)        | Check US availability, preview one account-only order, then choose the web or API path |
| [Bulk TikTok Account Creation](https://developers.tokportal.com/use-cases/platform-guides/bulk-tiktok-accounts-api)           | Correct bulk request shape and scaling limits                                          |
| [Python Quickstart](https://developers.tokportal.com/use-cases/platform-guides/python-quickstart)                             | Raw Python `requests` workflow with `X-API-Key` auth                                   |

## Industry Use Cases

These are operational playbooks that reuse the same API primitives.

| Guide                                                                                                                | Who it's for                                                                     |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [Agency Multi-Client Management](https://developers.tokportal.com/use-cases/industry/agency-multi-client-management) | Agencies grouping bundles by client with `title` and `external_ref`              |
| [UGC Distribution at Scale](https://developers.tokportal.com/use-cases/industry/ugc-distribution-at-scale)           | Brands distributing approved creator content across target markets               |
| [Music & Label Promotion](https://developers.tokportal.com/use-cases/industry/music-promotion-tiktok)                | Labels and artists scheduling content that uses a TikTok sound URL               |
| [TikTok Shop Product Seeding](https://developers.tokportal.com/use-cases/industry/tiktok-shop-product-seeding)       | E-commerce teams publishing product content without claiming native Shop tagging |
| [DTC Multi-Market Launch](https://developers.tokportal.com/use-cases/industry/dtc-multi-market-launch)               | DTC teams creating one API batch per market and comparing analytics              |

Need the full contract? Start with [Getting Started](https://developers.tokportal.com/getting-started) or the [OpenAPI reference](https://developers.tokportal.com/api-reference).
