API changelog
What changed in the REST API, webhooks and MCP server, newest first.
- Every
/v1route is documented from the code. The endpoint list, scopes, rate limits, webhook events, error codes and MCP tools on the website are generated, and a test fails when a route has no docs. - New webhook event you can subscribe to:
template.category_update(Meta changed a template's category). It was already sent, but could not be chosen.
- Every
POST /v1/contacts/importandPOST /v1/contacts/import/:id/confirm: send a spreadsheet (xlsx, CSV, pasted text or a Google Sheets link) and get back clean contacts; nothing is saved until you confirm.- Ticket events and ticket routes carry a short
summaryof the ticket, never the conversation transcript.
- WhatsApp groups API on numbers that qualify:
/v1/whatsapp/groupsto create groups, read and reset invite links, approve or reject join requests, remove participants and send messages. - Agent Line: keys with
agent:chat(chat-app connections) can now callPOST /v1/agent/notifyandPOST /v1/agent/ask.
- WhatsApp groups API on numbers that qualify:
- Agent Line:
POST /v1/agent/notify,POST /v1/agent/askandGET /v1/agent/inboxlet your agent text the owner on WhatsApp and wait for an answer.
- Agent Line:
- Teach the account AI over the API:
/v1/ai/knowledge,/v1/ai/instructions,/v1/ai/knowledge-gapsandPOST /v1/ai/test-reply(scopesknowledge:readandknowledge:write). - Plan-limit errors explain the limit in plain words and include an
upgrade_url.
- Teach the account AI over the API:
- Broadcasts:
/v1/broadcastswith estimate, preflight, recipient previews and launch. Lead magnets:/v1/lead-magnetsto draft, preview, publish and pause guides. - Comment AI controls:
/v1/comments/instructions(instructions per post),GET /v1/comments/postsandGET /v1/comments/settings.
- Broadcasts:
GET /v1/webhooks/:idreturns one webhook endpoint.
instant_ack_reactions_enabledis readable and writable through/v1/channels/ai-settings.
- MCP plans have a monthly request cap (MCP Starter 300,000, Growth 600,000, Pro 1,500,000). Over it:
429 MCP_MONTHLY_API_CAP_REACHED; at 80% a warning header is added.GET /v1/usagekeeps working.
- MCP plans have a monthly request cap (MCP Starter 300,000, Growth 600,000, Pro 1,500,000). Over it:
- MCP Starter, MCP Growth and MCP Pro plans, with their own per-minute limits (120, 600 and 1,200).
- API keys can be limited to chosen channels (
allowed_integration_ids); routes outside those channels answer403 API_KEY_CHANNEL_SCOPE_DENIED. Automations can be limited to one channel.
- API keys can be limited to chosen channels (
- Channel groups with their own AI brain:
/v1/channels/groups, group knowledge (including file upload) and AI providers per group or per channel (ElevenLabs voice, your own reply webhook).
- Channel groups with their own AI brain:
Idempotency-KeyonPOST /v1/messagesandPOST /v1/conversations/:id/messages; a send now returns 201 only when it was really sent, otherwise422 SEND_FAILED.GET /v1/status: public API health without a key.POST /v1/templates/:id/sendtakesintegration_idto pick the sending number;PATCH /v1/channels/:integration_idturns the AI on or off for one channel.
- Connect Claude, ChatGPT, Cursor and VS Code to the MCP server with OAuth sign-in.
POST /v1/agent/chattalks to Barq, the in-product agent.
- Connect Claude, ChatGPT, Cursor and VS Code to the MCP server with OAuth sign-in.
- The MCP server (
@instantreply.co/mcp) pairs itself with no API key: it shows a code, you approve it in the browser.
- The MCP server (