# 10ex Documentation

> https://docs.10ex.ai

Documentation for 10ex — an AI marketing & lead-gen platform. Sections follow the Diátaxis framework.

## Tutorials

- [Launch your first ads campaign across Google, LinkedIn, and Meta](https://docs.10ex.ai/tutorials/first-ads-campaign): Launch a multi-platform ads campaign with one brief. The ads-strategy-lab and ad-copy-generator agents build audiences, creative, and budget in one shot.
- [Generate and publish your first blog](https://docs.10ex.ai/tutorials/first-blog): Take a topic from brief to outline, draft, and published post on Webflow or Sanity using the blog-generation agent. End-to-end in about 15 minutes.
- [Run a webinar with the AI host](https://docs.10ex.ai/tutorials/first-webinar): Use the webinar-generator agent to take an outline through script, slides, AI-host video, registration page, and follow-up sequences in one flow.
- [Invite teammates and set roles](https://docs.10ex.ai/tutorials/invite-team): Add team members to your 10ex workspace, assign admin or member roles, and configure RBAC for shared brand knowledge, connectors, and agents.
- [Build a behavioral lead-scoring flow](https://docs.10ex.ai/tutorials/lead-scoring-flow): Score leads on engagement signals, then auto-trigger the voice-lead-qualifier agent when a lead crosses your threshold. No human watching dashboards.
- [Quickstart: zero to first launch](https://docs.10ex.ai/tutorials/quickstart): Sign up, fill brand knowledge, connect Gmail, import 50 leads, and launch your first AI email sequence with Nova in about 15 minutes, by hand or via MCP.

## How-to Guides

- [How-to guides](https://docs.10ex.ai/guides): Task-focused how-to recipes for the 10ex platform. Run agents, manage leads, build workflows, connect tools, and call the API programmatically.
- [Agent Hub](https://docs.10ex.ai/guides/agent-hub): How to browse, hire, configure, run, and approve AI agents from the 10ex Agent Store. Covers Active Agents, the cast, and the Configure panel.
- [Connectors](https://docs.10ex.ai/guides/connectors): How to connect Gmail, Google Ads, HubSpot, Drive, and 14 other providers to 10ex. Covers OAuth flow, BYOK, platform-managed keys, and per-agent requirements.
- [CRM](https://docs.10ex.ai/guides/crm): How to manage leads, segments, companies, and forms in 10ex. Covers imports, lifecycle stages, segment-driven motions, and how every agent reads the CRM.
- [Forms, native and external sync](https://docs.10ex.ai/guides/crm/forms): How to use 10ex native web forms and sync Meta, Google, and LinkedIn lead-gen ad forms. Learn when to pick which, plus setup, routing, and analytics.
- [Developers](https://docs.10ex.ai/guides/developers): How to authenticate, mint API keys, paginate list endpoints, subscribe to webhooks, handle rate limits, and connect Claude or Cursor to the MCP server.
- [API keys](https://docs.10ex.ai/guides/developers/api-keys): How to mint, list, rotate, and revoke 10ex API keys. Covers storage rules, scopes, rotation cadence, and how to keep tnx_ secrets out of git.
- [Authentication](https://docs.10ex.ai/guides/developers/auth): How to authenticate against the 10ex API and MCP server. When to pick a JWT vs an API key, how to mint each, and how to send the Authorization header.
- [MCP setup for Claude Desktop, Cursor, and VS Code](https://docs.10ex.ai/guides/developers/mcp-setup): How to connect the 10ex MCP server so Claude, Cursor, or VS Code agents can sign up users, connect Gmail, manage leads, and launch campaigns on your behalf.
- [Pagination](https://docs.10ex.ai/guides/developers/pagination): How to paginate 10ex list endpoints with cursors. Request shape, response shape, and a worked example for fetching every lead in a workspace.
- [Rate limits](https://docs.10ex.ai/guides/developers/rate-limits): What rate limits apply to the 10ex API and MCP server, how 429 responses behave, and the backoff strategy you should implement on the client side.
- [Webhooks](https://docs.10ex.ai/guides/developers/webhooks): How to subscribe to 10ex platform events, verify HMAC-SHA256 signatures, and handle retries. Includes a Node.js verification example and retry timing.
- [Knowledge](https://docs.10ex.ai/guides/knowledge): How to upload brand context, sync Google Drive and SharePoint, ingest URLs, and keep every 10ex agent on-brand. Covers the Knowledge Base, RAG, and re-indexing.
- [Marketing](https://docs.10ex.ai/guides/marketing): How to run ads, campaigns, blogs, email sequences, webinars, and videos in 10ex. Pick between manual surfaces and the agents that drive each channel.
- [Unified Chat](https://docs.10ex.ai/guides/marketing/chat): How to use 10ex Unified Chat to brief any agent conversationally. Covers agent-locked sessions, when to chat vs use a structured form, and routing patterns.
- [Improving email deliverability](https://docs.10ex.ai/guides/marketing/deliverability): How to land 10ex emails in the inbox, not spam. Domain authentication (SPF, DKIM, DMARC), warm-up, sending limits, list hygiene, content rules, Google and Microsoft bulk-sender requirements, monitoring, and troubleshooting.
- [Workflows](https://docs.10ex.ai/guides/workflows): How to build, run, and schedule 10ex workflows. Covers My Workflows, the Template Gallery, the visual canvas, and the 9 node categories you can compose.

## Reference

- [Reference](https://docs.10ex.ai/reference): Complete 10ex reference for the REST API, webhooks, MCP tools, error codes, and SDKs across every module of the marketing and lead-gen platform.
- [REST API overview](https://docs.10ex.ai/reference/api): 10ex REST API overview with base URL, authentication via JWT or API key, the full module catalog, error envelope, and OpenAPI spec endpoint.
- [agents](https://docs.10ex.ai/reference/api/agents): 10ex agents REST API for browsing the Agent Store, hiring CrewAI-backed agents, running executions, fetching results, and tracking cost and traces.
- [assets](https://docs.10ex.ai/reference/api/assets): 10ex assets REST API for storing and retrieving generated creative output, ad copy, images, slide decks, and videos, with version history and approval state.
- [chat](https://docs.10ex.ai/reference/api/chat): 10ex chat REST API for in-product conversational surfaces with streaming SSE responses, persistent threads, and per-workspace message history.
- [connectors](https://docs.10ex.ai/reference/api/connectors): 10ex connectors REST API for OAuth grants, BYOK keys, and per-workspace provider config across email, ads, CRM, and CMS sources and sinks.
- [crm](https://docs.10ex.ai/reference/api/crm): 10ex CRM REST API for managing leads, segments, companies, forms, lists, and bulk imports across JSON and CSV with public form submission support.
- [dashboard](https://docs.10ex.ai/reference/api/dashboard): 10ex dashboard REST API for read-only workspace metrics covering campaign health, agent runtime cost, lead pipeline counts, and deliverability stats.
- [flows](https://docs.10ex.ai/reference/api/flows): 10ex flows REST API for workflow CRUD, the template gallery, manual triggers, and ExternalTrigger management on CRM and connector events.
- [knowledge](https://docs.10ex.ai/reference/api/knowledge): 10ex knowledge REST API for ingesting URLs and files into brand context, plus vector retrieval over Qdrant powering RAG for every agent.
- [landing](https://docs.10ex.ai/reference/api/landing): 10ex landing REST API for generating, hosting, and analyzing landing pages with subdomain hosting, form embeds, and conversion analytics.
- [marketing](https://docs.10ex.ai/reference/api/marketing): 10ex marketing REST API for campaigns, email sequences, ads on Google, LinkedIn, and Meta, plus blog publishing across the asset and connector graph.
- [payments](https://docs.10ex.ai/reference/api/payments): 10ex payments REST API for Stripe subscriptions, plan switching, billing portal sessions, and read-only credit usage telemetry.
- [users](https://docs.10ex.ai/reference/api/users): 10ex users REST API for signup, login, password reset, email verification, Google OAuth, team membership, profile, and API key management.
- [videos](https://docs.10ex.ai/reference/api/videos): 10ex videos REST API for video asset CRUD, AI talking-head avatar generation, and stitching for webinar replays and short-form clips.
- [voice](https://docs.10ex.ai/reference/api/voice): 10ex voice REST API for realtime voice agents on the OpenAI Realtime API, powering inbound call qualification and the Voice Lead Qualifier crew.
- [webinars](https://docs.10ex.ai/reference/api/webinars): 10ex webinars REST API for generating, scheduling, hosting, and following up on webinars with AI host avatars, slides, and registration funnels.
- [Error codes](https://docs.10ex.ai/reference/errors): 10ex API error reference covering HTTP status codes, the validation error envelope, application error envelope, and recommended retry patterns.
- [MCP tools](https://docs.10ex.ai/reference/mcp): Complete catalog of every 10ex MCP tool across onboarding, setup, CRM, agent store, channel launches, workflows, and docs for AI-driven clients.
- [SDKs](https://docs.10ex.ai/reference/sdks): Official 10ex SDKs across TypeScript and Python, the OpenAPI spec endpoint, and recommended HTTP clients for hand-rolled integrations until SDKs ship.
- [Webhooks](https://docs.10ex.ai/reference/webhooks): 10ex webhook reference for event types, payload shape, HMAC signature verification, retry semantics, and subscribing via flows or the developer console.

## Concepts

- [10ex Documentation](https://docs.10ex.ai): Build lead lists, launch coordinated GTM campaigns, hire named AI agents, and drive any of it from code or MCP. Start with the Quickstart.
- [Concepts](https://docs.10ex.ai/concepts): Understand how 10ex thinks: the platform mental model, AI agents, flows, brand knowledge, lead scoring, and the orchestration layer that ties them together.
- [Agents architecture](https://docs.10ex.ai/concepts/agents): How 10ex agents are built, run, and observed: CrewAI crews under the hood, async Taskiq workers, Langfuse traces, and the credit-based billing model.
- [Approval workflows: human in the loop](https://docs.10ex.ai/concepts/approval-workflows): How 10ex agents pause before sending, publishing, or spending. Approval workflows give you a preview, an audit trail, and a kill switch for every irreversible action.
- [Brand knowledge schema](https://docs.10ex.ai/concepts/brand-knowledge): The exact fields every 10ex agent reads before it works. Company, ICP, Brand Voice, Brand Kit, and the 6-item onboarding checklist that unlocks Launchpad.
- [The cast: named agents](https://docs.10ex.ai/concepts/cast): Every 10ex agent is a named persona with a level, a specialty, and a per-run credit cost. Meet Marcus, Nova, Sora, and the rest of the team you can hire.
- [Connectors / BYOK](https://docs.10ex.ai/concepts/connectors): How 10ex connectors work. OAuth grants, BYOK keys, source vs sink roles, and why agents refuse to run when a required connector is missing.
- [Credits & pricing](https://docs.10ex.ai/concepts/credits): How 10ex charges per agent run, what "credits never expire" means, and which tier (Starter, Scale, or Pro) fits your go-to-market motion.
- [Customer lifecycle definitions: Prospect, Lead, MQL, SQL, Customer](https://docs.10ex.ai/concepts/customer-lifecycle): Clear 10ex definitions for Prospect, Lead, Marketing Qualified Lead (MQL), Sales Qualified Lead (SQL), Customer, and every CRM lead status.
- [Flows](https://docs.10ex.ai/concepts/flows): How 10ex flows tie triggers, conditions, and agent runs into orchestrated workflows. Schedule jobs, react to CRM events, and branch on lead data.
- [Knowledge & RAG](https://docs.10ex.ai/concepts/knowledge): How 10ex agents stay on-brand and on-context. The knowledge layer covers brand context, ICPs, past outputs, and Qdrant-backed vector retrieval.
- [Launchpad: strategic playbook](https://docs.10ex.ai/concepts/launchpad): Launchpad turns your brand knowledge and connected channels into a 30-day go-to-market plan, sequencing the right agents at every step so you can launch fast.
- [Behavioral lead scoring](https://docs.10ex.ai/concepts/lead-scoring): How 10ex scores lead intent from CRM, web, and engagement signals. Event-sourced scoring with decay curves and threshold-driven flow triggers.
- [Platform mental model](https://docs.10ex.ai/concepts/platform): How 10ex thinks about the GTM motion. Five primitives (leads, knowledge, connectors, agents, flows) and the order they compose in every playbook.
- [Roles & team permissions](https://docs.10ex.ai/concepts/roles): Admin, Manager, and Member roles in 10ex workspaces. What each role can and cannot do, how to invite teammates, and where SSO and SCIM stand.
- [Webinars at scale](https://docs.10ex.ai/concepts/webinars): How 10ex generates webinars end-to-end. Outline, slides, AI host avatar, replay video, registration page, and follow-up sequences from one crew run.

## Use Cases

- [Use cases](https://docs.10ex.ai/use-cases): GTM playbooks by channel. Pick email, ads, blogs, webinars, or integrations. Each section ships full motions with the agents who run them end to end.
- [Ads playbooks](https://docs.10ex.ai/use-cases/ads): Run paid social on Google, LinkedIn, and Meta with Maya, Luna, Dante, Zara, Ravi, and Elena. CRM audiences, retargeting, creative variants, approval-gated.
- [Blog playbooks](https://docs.10ex.ai/use-cases/blogs): Ship SEO blog clusters with Marcus. Brief to outline to draft to published post in Webflow or Sanity, then repurposed into LinkedIn and ad copy via Luna.
- [Email playbooks](https://docs.10ex.ai/use-cases/email): Ship cold email, nurture, re-engagement, and reply-handling sequences with Nova and Orion. Deliverability checks, approval gating, and Gmail/Outlook included.
- [Integration playbooks (CrewAI, Claude, Cursor, MCP)](https://docs.10ex.ai/use-cases/integrations): Drive 10ex from Claude, Cursor, or CrewAI via MCP, or extend the platform with your own crew. Three production-ready integration patterns for developers.
- [Webinar playbooks](https://docs.10ex.ai/use-cases/webinars): Generate, host, and follow up on webinars at scale with Atlas, Iris, and Nova/PPT. Slides, talking-head video, registration funnel, and replay workflow.

## Agent Store

- [AI agents catalog for marketing and lead-gen automation](https://docs.10ex.ai/agents): Browse 16 named 10ex agents by channel. Find inputs, connectors, outputs, and the MCP tools behind each one for email, ads, content, and prospecting.
- [Luna: Ad Copy Generator](https://docs.10ex.ai/agents/ad-copy-generator): Generate on-brand ad headlines and primary text for Google, LinkedIn, and Meta. Per-platform character limits and hook patterns enforced automatically.
- [Maya: Ads Strategy Lab](https://docs.10ex.ai/agents/ads-strategy-lab): Plan multi-platform paid ads strategy before launch. Maya defines ICP, targeting, awareness stages, and campaign structure across Google, LinkedIn, and Meta.
- [Marcus: Blog Generation](https://docs.10ex.ai/agents/blog-generation): Generate cited, brand-aligned SEO blog posts end-to-end. Marcus runs keyword research, drafts, visuals, and publishes to Webflow or Sanity.
- [Dante: Creative Studio](https://docs.10ex.ai/agents/creative-studio): Generate on-brand ad creatives across Google, LinkedIn, and Meta. Dante produces multiple visual variants per platform in your brand palette and aspect ratios.
- [Orion: Email Outreach](https://docs.10ex.ai/agents/email-outreach-sender): Send a single personalized cold email via Gmail in one step. Orion writes one-off outbound for referrals, follow-ups, and custom replies.
- [Nova: Email Sequence Generation](https://docs.10ex.ai/agents/email-sequence-generation): Launch personalized multi-step cold email sequences via Gmail or Outlook. Nova writes brand-aware, lead-aware outbound and gates before any spend.
- [Zara: Google Ads Manager](https://docs.10ex.ai/agents/google-ads-manager): Launch Google Ads campaigns end-to-end across Search, Display, Video, Shopping, Performance Max, Discovery, App, and Local. Approval gate before any spend.
- [Sora: Growth Audit Crew](https://docs.10ex.ai/agents/growth-audit): Audit your website for traffic, performance, SEO, and UX issues. Sora produces a prioritized punch-list with GA4 and Search Console data baked in.
- [Ravi: LinkedIn Ads Manager](https://docs.10ex.ai/agents/linkedin-ads-manager): Launch LinkedIn campaigns end-to-end across Sponsored Content, Message, Dynamic, and Text Ads. Approval gate before any spend.
- [Juno: Market Research Crew](https://docs.10ex.ai/agents/market-research-crew): Get actionable market, competitor, and trend research with charts, mailed to you. Juno runs free and feeds Maya's strategy and Marcus's content.
- [Elena: Meta Ads Manager](https://docs.10ex.ai/agents/meta-ads-manager): Launch Facebook and Instagram campaigns end-to-end across all six Meta objectives. Sequential CrewAI workflow with approval gate before any spend.
- [Nova: PPT Generator](https://docs.10ex.ai/agents/ppt-generator): Generate brand-aligned slide decks via Gamma with art-directed images in your palette. Sales decks, proposals, and all-hands ready in minutes.
- [Marcus: Prospector Agent](https://docs.10ex.ai/agents/prospector-agent): Find and enrich ICP-matched leads from Apollo, saved straight to your 10ex CRM. No Apollo account needed, the platform manages the API key.
- [Kai: Lead Qualifier Agent](https://docs.10ex.ai/agents/voice-lead-qualifier): Run AI voice calls that qualify leads in conversation and book the next step. Kai dials at 1 credit per call and posts results back to your CRM.
- [Atlas: Webinar Video Generator](https://docs.10ex.ai/agents/webinar-generator): Generate a complete webinar bundle: outline, script, slides, talking-head video, and a Zoom-style stitched final, all hands-off and brand-aligned.
- [Iris: Webinar Image Generator](https://docs.10ex.ai/agents/webinar-image-generator): Generate on-brand webinar covers and promo images in your palette and fonts. Iris ships every aspect ratio you need from a single brief.