New: Kwamle AI Studio is live — build intelligent chatbots in minutes.Discover →
Resources

REST API.

A modern REST API for everything in Kwamle Media — bots, subscribers, posts, stores, and AI.

REST API.

Base URL

https://app.kwamlemedia.com/api/v1

Authentication

Every request requires a Bearer Token in the header:

Authorization: Bearer YOUR_API_TOKEN

Get your token from Settings → API Keys.

Bots

GET/bots
List all your bots.
GET/bots/{id}
Details of a specific bot.
POST/bots
Create a new bot.
PATCH/bots/{id}
Update a bot's data.
DELETE/bots/{id}
Delete a bot.

Subscribers

GET/subscribers
List subscribers with pagination.
GET/subscribers/{id}
Data for a specific subscriber.
POST/subscribers/{id}/messages
Send a message to a specific subscriber.
POST/subscribers/{id}/tags
Add a tag to a subscriber.

Posts

GET/posts
List scheduled and published posts.
POST/posts
Create/schedule a new post.

Ecommerce

GET/products
List products.
POST/products
Add a new product.
GET/orders
List orders.

AI Studio

POST/ai/chat
Multi-provider AI call with automatic selection.
GET/ai/usage
Daily token consumption statistics.

Example request

curl -X POST https://app.kwamlemedia.com/api/v1/ai/chat \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Write me an ad for a new product"}
    ],
    "max_tokens": 500
  }'

Webhooks

Subscribe to live platform events (new message, new order, new comment):

POST /webhooks
{
  "url": "https://yourdomain.com/webhook",
  "events": ["message.received", "order.created", "comment.posted"]
}

Rate Limiting

  • Free: 60 requests/min
  • Pro: 600 requests/min
  • Enterprise: 6,000 requests/min + custom

The X-RateLimit-Remaining and X-RateLimit-Reset headers return real-time information.

Official SDKs in development

Coming soon: libraries for Node.js, Python, PHP, and Go.
For technical questions: api@kwamlemedia.com