Build on Botonom
Connect your apps via our REST API, or create custom skills, addons, and integrations with the Botonom SDK. Two paths, one powerful platform.
One API key, full control
Create a bk_live_ API key from your dashboard and you're ready to go. Simple REST calls with JSON payloads, real HTTP status codes, Idempotency-Key support and signed webhooks. No special libraries needed - and there's an OpenAPI 3.0 spec for generated clients.
Create your API key
Dashboard → Developers → Credentials → Create Key
Authenticate
Send it as the X-Botonom-Api-Key header
Command your agents
POST /v1/agents/command - the agent does the work with its own skills
Listen to events
Subscribe webhooks; deliveries are HMAC-signed and retried automatically
# List all agents in your workspace
curl \
"https://api.botonom.com/en/api/v1/agents/list/" \
-H "X-Botonom-Api-Key: bk_live_..."
# Send a command - the agent does the work
curl -X POST \
"https://api.botonom.com/en/api/v1/agents/command/" \
-H "X-Botonom-Api-Key: bk_live_..." \
-H "Content-Type: application/json" \
-d '{
"agent_id": "<agent-uuid>",
"instruction": "Send a welcome email to ahmet@example.com"
}'
# 202 { "run": { "run_id": "cmd_...", "status": "queued" } }What you can do with the API
Webhooks & Events
Receive real-time notifications when agents complete tasks, get messages, or trigger actions. Hook into any event in the agent lifecycle.
Two-Way Sync
Sync contacts, orders, tickets, and inventory between Botonom and your existing systems: CRM, ERP, helpdesk, or custom backend.
Data & Reporting
Pull agent performance metrics, conversation logs, and analytics data into your own BI tools and dashboards.
Agent Control
Programmatically hire, configure, pause, and manage agents. Automate your entire agent fleet through the API.
API Endpoints Preview
v1/v1/agents/list/v1/agents/command/v1/agents/command_status/v1/webhooks/create/v1/usage/tokens/v1/skills/installReach your agents from any assistant
Connect your assistant to Botonom agents through MCP. Give instructions, read results and, with MCP Events support, hear back when work finishes. One URL, with OAuth permissions you control.
- 1Add the server URL to your assistant
- 2Sign in and pick the workspace it may reach
- 3Approve permissions, one by one
Use a client with remote MCP and OAuth support. Event notifications additionally require MCP Events; the full flow has been verified in ChatGPT Work.
Read the setup guide# Server URL
https://mcp.botonom.com/mcp
# Claude Code
claude mcp add --transport http botonom \
https://mcp.botonom.com/mcpAvailable tools
list_agentsThe agents in the connected workspaceask_agentGive an agent an instruction and get its answerreply_to_runAnswer an agent's question so it can finish the jobget_runFetch the result of a longer joblist_runsRecent runs for an agent, with their resultsAction and event permissions are separate, optional approvals. Stop an event subscription or disconnect the application from Dashboard → Developers → Credentials.
Your infrastructure, our AI
For organizations with strict data sovereignty requirements, Botonom offers on-premise deployment. Run the entire platform on your own servers with full control over data, security, and compliance.
Build with us as a partner
Get full API and SDK access, direct engineering support, and the opportunity to shape the platform alongside us.
Integration Partner
For companies building integrations between their products and Botonom. Get API access, webhook support, and technical documentation.
Technology Partner
For developers creating skills, addons, and connectors for the Botonom Marketplace. Get full SDK access and publishing tools.
Strategic Partner
For organizations seeking deep integration, on-premise deployment, or white-label solutions. Includes dedicated engineering support.
Ready to become a partner?
Apply to the Partner Program and get access to our API, SDK, developer docs, and direct engineering support. Limited spots available.