SmartChat API
The SmartChat API lets your software do what you do in the SmartChat app: read and save contacts, send a message, prepare and send a newsletter, build an automation, edit the landing page and get notified when something happens. The MCP server gives AI assistants such as Claude and ChatGPT most of these abilities. Some calls are REST only: see REST to MCP.
Everything is English: field names, values, error codes and tool names. There is one error format, one way to page through lists and one way to repeat a call safely.
#Start here
| I want to... | Go to |
|---|---|
| Make my first call in under 5 minutes | Quickstart |
| Create a key and choose its permissions | Authentication |
| Look up a call | API reference |
| Understand errors, lists and retries | Concepts |
| Follow a complete example | Guides |
| Get notified when something happens | Webhooks |
| Connect Claude, ChatGPT, Zapier, Make or n8n | MCP server |
#The facts in one table
| Base URL | https://api.smartchat.marketing/v1 |
| Sign-in | Authorization: Bearer <key> (details) |
| Format | JSON in, JSON out. Times are ISO 8601 in UTC. |
| Errors | One format for every error (details) |
| Lists | Cursor pages, 20 items by default, at most 100 (details) |
| Safety net | 120 requests per minute per key (details) |
| Version | 2026-10-25, shown in the SmartChat-Version header (details) |
#Machine-readable
- OpenAPI (JSON) and OpenAPI (YAML): the one source of the API description.
- Postman collection.
- llms.txt and all pages in one file for AI assistants. Every page also exists as Markdown: add
.mdto the address.