API & AI agents: drive Pamba programmatically

Everything the Pamba UI does, an agent can do through the API. The full public API reference lives at pamba.app/api: endpoint auth, request and response structures, credit usage, and examples.

Authentication

• •Base URL: https://api.pamba.app
• •Agent auth: X-API-Key header. Open account settings and select Workspace Settings, then find API Keys directly below Company name. You can also open workspace settings from the workspace switcher.
• •JWT callers must include X-Workspace-Id on workspace-scoped routes; API-key callers don't, since the key already carries the workspace.

Connect an MCP client instead

Claude Code, Codex, Cursor and other MCP clients can drive Pamba without any guide file: the MCP server exposes every tool the in-app assistant has at https://api.pamba.app/mcp, with the product knowledge built in. The MCP tool reference lists all of them.

Give your agent the guide

Download the guide matching your agent and drop it in its context:

• •CLAUDE.md guide for Claude agents
• •Codex guide
• •Generic agent guide

Once your agent has it, a prompt like "What can you do with Pamba?" should produce a concrete menu of workflows, not stale endpoint guesses.

What your agent can do

Track TikTok accounts and mine analyzed videos; add ideas and scripts in bulk; create project batches as drafts or fully generated videos; generate clips and select takes; check when an account's phone is free (GET /devices/accounts/schedule) and schedule, reschedule, cancel, and retry posts; configure warming; create avatars from reference images; manage starting-frame libraries; and pull analytics dashboards and account metrics.

Credits

Generation spends credits (clip generation per model-second, avatar photos and scenes at 15 credits per image, voices at 100, premium voice clones at 1500, hook purchases at 200). Failed operations are never charged, and insufficient-credit requests return 402 Payment Required with remaining_credits and required_credits. The live price list is public at GET /usage/pricing; use GET /user for subscription state and credit totals.

This help center is agent-readable too

Every article here is available as raw markdown: see /llms.txt for the index and /llms-full.txt for the whole term list in one document.