SmartChat API

The SmartChat REST API gives you access to everything you can do in the SmartChat app. It is used by Zapier, Make, n8n, your own code and the Claude connector.

Base URL and authentication

All requests go to the base URL below. Send your API key as a Bearer token. Create keys in SmartChat under Settings > API keys and give each key only the permissions it needs.

https://api.smartchat.marketing/v1

curl https://api.smartchat.marketing/v1/me \
  -H "Authorization: Bearer sk_live_..."

Full reference

The complete machine-readable description (OpenAPI 3) with every endpoint, field and error:

https://api.smartchat.marketing/v1/openapi.json
https://api.smartchat.marketing/v1/openapi.yaml

Main areas

`/contacts`	Contacts, tags, opt-in
`/messages, /sends`	Send WhatsApp messages and templates, check delivery
`/inbox`	Conversations and messages
`/templates`	WhatsApp templates, submit to Meta
`/newsletters`	Newsletters, schedule, cancel, status
`/followups`	Follow-up sequences and steps
`/automations`	Automations, runs, trigger
`/media`	Media library, upload (multipart, url or base64)
`/tools`	Every SmartChat AI tool directly, for example update_landing or create_newsletter
`/app`	Further app functions: inbox replies, AI settings, widgets, domains, team, billing (read)
`/webhook-subscriptions`	Get events pushed to your system
`/stats, /me, /settings`	Figures, account and settings

Rules

Rate limit: 120 requests per minute per key. Above that you get 429 with retry-after.
Idempotency: send an Idempotency-Key header on sends to avoid duplicates (kept 24 hours).
Errors come as JSON with a code and an English message.
Messages only go to contacts who confirmed their WhatsApp sign-up. Outside the 24-hour window only approved templates are sent.

Two-step actions

Tools that send, schedule, submit or delete first return a preview and a confirm_token. Call the same tool again with confirm_token to execute. Nothing happens on the first call.

Questions?

Email us at support@smartchat.marketing