Build on Ballet programmatically — run playbooks via REST and MCP, stream run events, wire playbooks into agent frameworks (Vercel AI SDK, LangChain, Mastra, Google ADK), and connect playbooks to external systems.

How do I authenticate with the Ballet API?

How do I connect to Ballet's MCP endpoint?

How do I run a playbook over the REST API?

How do I stream playbook run events?

How do I trigger and react to playbooks with webhooks?

How do I wake a suspended run with reply or resume?

Developer foundations

How do I call Ballet playbooks from Google ADK?

How do I call Ballet playbooks from LangChain?

How do I call Ballet playbooks from Mastra?

How do I call Ballet playbooks from Pydantic AI?

How do I call Ballet playbooks from the Vercel AI SDK?

How do I use Ballet playbooks in an agent framework?

How do I call external APIs and SDKs from a playbook?

How do I connect external MCP servers to playbooks?

How do I use secrets and env vars in steps?

How do playbooks connect to external systems?

Introduction

Developer Docs

Build your first automation with Ask Ballet

Deterministic agents: Ballet's approach

Getting Started with Ballet

How do I join the early access program?

How do I navigate the Studio (sidebar + command palette)?

How do I sign in and access my workspace?

What happens during workspace onboarding?

What is Ballet?

What to expect as a design partner

What's the difference between Builder and Member mode?

Ballet vs Automation Anywhere

Ballet vs Claude Cowork

Ballet vs Moveworks (ServiceNow)

Ballet vs n8n

Ballet vs Power Automate

Ballet vs Temporal

Ballet vs UiPath

Ballet vs Workato

Ballet vs Zapier

Why Ballet

Getting Started

Building Playbooks

How do I build a playbook with the Console (Ask Ballet)?

How do I edit steps (Code and HTTP)?

How do I use the playbook workspace (Play / Code / History)?

How does the Plan vs Build flow work?

What are Allow vs Ask permission modes?

What is a playbook?

How do I manage Schedules?

How do I pause and resume a playbook run?

How do I read runs and run history?

How do I run a playbook?

How do I share run output?

Run from your environment via API

Running and Automating

What triggers can start a playbook (Manual, Schedule, Webhook)?

Connecting Tools

How do first-party integrations (Cursor, Freshdesk) work?

How do I connect an MCP server?

How do I connect CRM and support tools?

How do I connect Genesys Cloud?

How do I connect HubSpot?

How do I connect Salesforce?

How do I connect ServiceNow?

How do I connect Zendesk?

How do I store credentials with Secrets?

What is a connector and how do I browse the registry?

How do I create and use API tokens?

How do I invite users?

How does usage and billing work?

What are the roles and permissions (Owner/Builder/Member)?

What is the AI Gateway / Ballet Models?

Workspace and Admin

Ballet glossary

Concepts and Glossary

How do Collections and Git sync work?

What are Agents?

What are Skills?

What are Tools and the playground?

Recipe: Data sync and ETL to a warehouse

Recipe: Scheduled reports and readouts

Data Ops recipes

Recipe: AI code review on pull requests with Cursor

Recipe: Incident response and on-call paging

Recipe: Triage new errors into tracked issues

Engineering Ops recipes

Recipe: Invoice and expense processing

Recipe: Reconcile payments and payouts

Finance Ops recipes

Recipe: Campaign performance report

Recipe: Competitor monitoring digest

Recipe: Content and marketing operations

Recipe: Generate a content brief

Marketing Ops recipes

Recipe: Automate new customer onboarding

Recipe: Enrich new leads automatically

Recipe: Score, route, and follow up on leads

RevOps recipes

Recipe: Auto-answer and deflect common tickets

Recipe: CSAT follow-up after ticket resolution

Recipe: Escalate SLA breaches and priority tickets

Recipe: Triage and route support tickets

Support Ops recipes

Playbook Recipes

Guide

Recipes

Developer

Ballet 