DEVELOPER PLATFORM

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.

Currently available to Partner Program members only

Apply for Partnership Read the Docs API Playground

API ACCESS

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

api-example.sh

# 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

GET/v1/agents/listList all agents in your workspace

POST/v1/agents/commandGive an agent a natural-language command (async, 202 + run_id)

GET/v1/agents/command_statusPoll a command run for its result

POST/v1/webhooks/createSubscribe your endpoint to signed agent events

GET/v1/usage/tokensToken usage with daily series and per-agent breakdown

POST/v1/skills/installInstall or remove agent skills

ON-PREMISE

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.

Full data sovereignty, nothing leaves your infrastructure

Deploy on AWS, Azure, GCP, or bare-metal servers

Air-gapped environment support

Custom SSO/SAML integration with your identity provider

Dedicated support engineer and SLA guarantees

Automated updates with rollback capabilities

Contact Sales

Agent Runtime

Skill Engine

Data Layer

Auth & SSO

Your private cloud / on-prem

PARTNER PROGRAM

Build with us as a partner

Get full API and SDK access, direct engineering support, and the opportunity to shape the platform alongside us.

Full API access with dedicated rate limits

Early access to SDK builds and private repos

Private Discord channel with our engineering team

Priority documentation and onboarding support

Revenue share on Marketplace published skills

Co-marketing opportunities and partner badge

Integration Partner

For companies building integrations between their products and Botonom. Get API access, webhook support, and technical documentation.

API + Webhooks

Technology Partner

For developers creating skills, addons, and connectors for the Botonom Marketplace. Get full SDK access and publishing tools.

SDK + Marketplace

Strategic Partner

For organizations seeking deep integration, on-premise deployment, or white-label solutions. Includes dedicated engineering support.

Full Platform Access