Bearer keys, scoped
Live and test keys. Scopes per resource. Rotate without downtime.
v1 live · all systems operational
WhatsApp + Instagram
API, plain and fast.
One REST API and one MCP server. Read Instagram DMs, send WhatsApp replies, qualify hot leads, sync to your CRM. Free on every plan and on the 10-day Pro trial.
- v1 endpoints
- 22
- MCP tools
- 12
- req/min · Pro
- 2.4k
Example · POST /v1/conversations/:id/messages
# Send a reply from any backend, any agent, any cron
curl -X POST https://api.instantreply.co/v1/conversations/$ID/messages \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "On its way. Tracking link to follow." }'
# 201 Created
{ "id": "msg_8f2a", "direction": "outbound", "delivered_at": "..." }Bearer auth. JSON in, JSON out. ir_test_ keys never deliver, ever.
What you ship with
Production primitives, not toys.
MCP server, day one
One npx command and Claude, Cursor, or Windsurf is in your inbox.
Signed webhooks
HMAC-SHA256, ordered delivery, 30-day retry log per endpoint.
Sandbox by default
ir_test_ keys hit seeded data. Build the full integration before sending one real message.
Idempotency, cursors
Pass Idempotency-Key on POST. Cursor pagination on every list. No duplicate side effects.
Predictable errors
{ error: { code, message, doc_url, request_id } } on every failure. X-Request-Id on every response.
Template lifecycle API
Validate category fit, check policy risk, and submit to Meta — without opening Meta Business Manager. UTILITY templates cost ~66% less than MARKETING; the validate endpoint tells you exactly which phrases to change to qualify.
Explainable delivery failures
Every important error returns what happened, why it failed, whether the fault is ours or Meta's, and the next safe step — in plain English, not just an error code.
First call · five minutes
Three lines, one inbox.
- 01
Create a key
Settings → API Keys → New. Pick scopes. Copy once.
dotenv # .env IR_API_KEY=ir_live_3f2a... - 02
List conversations
Cursor pagination, 100 per page max.
bash curl https://api.instantreply.co/v1/conversations \ -H "Authorization: Bearer $IR_API_KEY" - 03
Send the reply
Sandboxed automatically for ir_test_ keys.
bash curl -X POST .../v1/conversations/$ID/messages \ -H "Authorization: Bearer $IR_API_KEY" \ -d '{"content":"On its way."}'
Included on every plan
No developer tier. No card on the trial.
| Plan | Requests / min | Active keys | Webhooks | MCP server |
|---|---|---|---|---|
| Free | 30 | 1 | 1 | Read-only |
| Trial (10 days, Pro) | 600 | 5 | 10 | Full |
| Starter · $59 / mo | 120 | 2 | 3 | Full |
| Growth · $129 / mo | 600 | 5 | 10 | Full |
| Pro | 2,400 | 25 | 25 | Full + priority |
| Enterprise | Custom | Unlimited | Custom | Dedicated |
Surfaces
Pick the entry point.
- ↗API referenceLive, interactive OpenAPI explorer
- ↗QuickstartFirst call in five minutes, real keys
- ↗MCP serverTwelve tools, six prompts, two resources
- ↗REST endpointsTwenty-two v1 endpoints — conversations, templates, delivery debug, developer onboarding
- ↗Node.js SDKnpm install @instantreply/node
- ↗Python SDKpip install instantreply
- ↗Developer HubJourney docs, playground, send history
You already have access
Open the dashboard. Create a key. Make a call.
The API ships with your account. No application form, no review queue, no separate billing.
Setup by agent
Pick your editor. Drop the block. Done in 30 seconds.
Pre-written config snippets for every MCP-capable client. Each guide ships the exact JSON to paste, the file path to drop it in, and three example prompts to try.