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 token, full control
Generate an API token from your Botonom dashboard, and you're ready to go. Our RESTful API uses standard HTTP methods with JSON payloads, no special libraries needed.
Generate token
Panel → Settings → API → Create Token
Authenticate
Include Bearer token in request headers
Make requests
Standard REST: GET, POST, PUT, DELETE
Listen to events
Register webhooks for real-time updates
# List all agents in your workspace
curl -X GET \
"https://api.botonom.com/v1/agents" \
-H "Authorization: Bearer btm_sk_..."
# Send a message to an agent
curl -X POST \
"https://api.botonom.com/v1/agents
/agt_abc123/message" \
-H "Authorization: Bearer btm_sk_..." \
-H "Content-Type: application/json" \
-d '{
"content": "Book a table for 4 at 7pm",
"channel": "api"
}'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, including 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/v1/agents/{id}/message/v1/agents/{id}/tasks/v1/webhooks/v1/analytics/usage/v1/agents/{id}/skillsYour 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.