Messages Improved
v2.1 — 70+ Endpoints

Build AI Agents
With Code, Not Clicks

70+ endpoints. Full platform access. Create, train, deploy, and manage AI agents that handle calls, texts, and chats — entirely through our API.

70+ endpoints13 API categoriesREST + OpenAPI 3.02-header auth

Get started in 3 steps

No SDK required. Just HTTP requests with two headers.

1

Sign up & get your API key

Create an account at the dashboard. Go to any bot's settings and click Generate API Key.

api-key: sk-your-api-key
admin-email: you@company.com
2

Create & train a bot

One POST to /create_bot gives you a bot ID. Then upload files, scrape a website, or add data feeds.

3

Deploy anywhere

Chat via API, assign a phone number for SMS/voice, embed the web widget, or set up webhooks for real-time events.

From zero to AI agent in 5 API calls

Create a bot, train it, give it a phone number, and text a customer.

# 1. Create a bot
curl -X POST https://botsettings.messagesimproved.com/create_bot \
  -H "api-key: YOUR_API_KEY" -H "admin-email: you@company.com" \
  -d '{"name": "Sales Agent", "prompt": "You are a helpful sales assistant."}'

# 2. Train it on your website
curl -X POST https://botsettings.messagesimproved.com/scrape_website \
  -H "api-key: YOUR_API_KEY" -H "admin-email: you@company.com" \
  -d '{"selectedBot": "BOT_ID", "url": "https://acme.com", "recursive": true}'

# 3. Chat with it
curl -X POST "https://bot.messagesimproved.com/conversation_api?\
  input=What+services+do+you+offer&bot=BOT_ID&creator=you@company.com&\
  api_key=YOUR_API_KEY&user_id=customer_123"

# 4. Give it a phone number
curl -X POST https://botsettings.messagesimproved.com/rent_twilio_number \
  -H "api-key: YOUR_API_KEY" -H "admin-email: you@company.com" \
  -d '{"selectedBot": "BOT_ID", "role": "sms", "plan": "professional"}'

# 5. Send an SMS
curl -X POST https://botsettings.messagesimproved.com/direct_sms_api \
  -H "api-key: YOUR_API_KEY" -H "admin-email: you@company.com" \
  -d '{"selectedBot": "BOT_ID", "recipient_phone": "+15551234567", "message": "Hey!"}'

13 API categories. Every platform capability.

Everything you can do in the app, you can do through the API.

Authentication
6

Signup, login, OAuth, API key generation

Bot Management
8

Create, list, configure, and toggle bots

Prompt Engineering
12

System prompts, behavior tuning, UI settings, retraining

Training & RAG
8

Upload docs, scrape sites, manage knowledge base

Conversations
5

Chat, history, human injection, bulk messaging

Users & Subscribers
5

Bot users, SMS subscribers, lifecycle management

Phone & SMS
5

Attach numbers, send SMS, manage limits

Twilio
7

Search, purchase, import, assign phone numbers

Voice
6

Voice providers, outbound calls, voice config

Analytics
5

Message counts, conversations, usage stats, logs

Notifications
3

Email alerts, transcripts, notification settings

Webhooks
1

Real-time events pushed to your server

Payments
2

Custom plans, subscription management

73 endpoints across 13 categories

Built for builders

SaaS Builders

White-label AI agents under your own brand. We're the infrastructure, you're the product.

Enterprise

Integrate AI agents into your CRM, helpdesk, or ERP. Run hundreds of bots across hundreds of domains.

Telecoms

Deploy AI agents to millions of subscribers. Telecom-scale SMS and voice deployments.

Agencies

Build and manage AI agents for your clients. One API, unlimited clients.

Developers

Skip the infrastructure. RAG, prompt management, phone routing, conversation state — all built.

Automators

Connect AI agents to any workflow via webhooks. Real-time events, message injection, full control.

What you get

Full platform parity — everything in the app, via API
Two-header auth — API key + email on every request
Standard REST — HTTP methods, JSON payloads, predictable URLs
OpenAPI 3.0 spec — auto-generate clients in any language
Webhooks — real-time events pushed to your server
Multi-bot support — unlimited bots from one account
Model selection — GPT-4 and GPT-4o per conversation
RAG built in — upload docs, scrape sites, add feeds
Phone infrastructure — Twilio numbers, SMS, voice, managed
Voice AI — Bland AI and OpenAI Realtime, one API call to switch

Start building

Sign up, generate your API key, and create your first AI agent — all in under 5 minutes.