Embed an agent in your app
Use the SDK to add an agent to your mobile or web app.
A versioned API for agents, conversations, knowledge, CRM and usage; scoped keys, signed webhooks, an embeddable SDK and a sandbox to try it all safely.
curl https://api.<your-domain>/v1/agents/agt_site_visit/runs \
-H "Authorization: Bearer $MAI_API_KEY" \
-H "Idempotency-Key: crm-lead-88231" \
-d '{"input": "3 BHK under 1.2 Cr, visit Saturday?",
"contact": {"phone": "+9198XXXXXX10"}}'
# 202 Accepted
{"run_id": "run_7Hq...", "status": "queued"}The API is versioned in the URL and only changes additively within a version. Writes accept an Idempotency-Key so retries never create duplicates.
Webhooks are signed with a timestamp so you can verify they came from us and reject replays.
Each capability shows when it is scheduled to ship and whether it depends on a provider's approval.
Agents, conversations, knowledge, CRM and usage endpoints.
Least-privilege keys you can rotate.
Subscribe to events; verify signatures.
Chat widget and in-app SDK.
Safe testing with clear limits and request logs.
Send and receive WhatsApp messages from your own systems.
Indicative endpoints for Phase 11. Final names are published in the API reference when they ship.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/agents/{id}/runs | Run an agent with an input and contact |
| GET | /v1/conversations | List conversations with filters |
| POST | /v1/knowledge-bases/{id}/sources | Add a document, URL or API source |
| POST | /v1/contacts | Create or update a CRM contact |
| GET | /v1/usage | Usage against plan limits |
| POST | /v1/webhook-subscriptions | Subscribe to signed event webhooks |
Use the SDK to add an agent to your mobile or web app.
Webhooks push conversation events to your systems.
Start an agent run when a lead is created.
Scope it to what your integration needs.
Test calls without touching production.
Receive signed events.
Switch to a production key.
Custom REST API
Coming soon
n8n webhooks
Coming soon
Make webhooks
Coming soon
Zapier webhooks
Coming soon
Still unsure? Ask the team.
Book a walkthrough to see what is ready today, what each phase adds and how a pilot would work for your business.