Connect the WhatsApp API
Integrate the WhatsApp API through Modiva’s unified REST API and hosted MCP server. Send and receive WhatsApp messages. OAuth, token refresh, rate limits and 11 typed tools are handled for you — connect once and call WhatsApp from any agent or app through a single endpoint.
What you can do with the WhatsApp API
- ✓ Publishing
- ✓ Scheduling
- ✓ Inbox & DMs
- ✓ Analytics
- ✓ Webhooks
WhatsApp MCP tools & scopes
- accounts_
- list · health · status
- posts_
- create · cross_post · schedule · publish_now
- comments_
- list · reply
- messages_
- list · send · inbox
- analytics_
- unified · best_time_to_post
OAuth scopes requested
- Read profile & accounts
- Publish posts & stories
- Read insights
- Read & reply to comments/DMs
Connect WhatsApp in your agent
# Add Modiva's MCP server to your agent
{
"mcpServers": {
"modiva": {
"url": "https://mcp.modiva.ai",
"headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
}
}
}
# Then connect WhatsApp and call its tools, e.g.
accounts_list(provider="whatsapp")Frequently asked questions
How do I connect the WhatsApp API with Modiva?
Create a Modiva account, generate an MCP key, and connect WhatsApp from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.
What can I do with the WhatsApp API through Modiva?
Send and receive WhatsApp messages. You get 11 typed tools grouped by resource (accounts_, posts_, comments_, messages_, analytics_), callable over REST or the MCP server.
Do I need to handle OAuth or token refresh myself?
No. Modiva handles the WhatsApp OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.
Can an AI agent use the WhatsApp API?
Yes — that is the point. Modiva exposes WhatsApp as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on WhatsApp through one endpoint.