Get started
Build on Trovacast
One REST API for WhatsApp, SMS, email and voice — calls, call control, IVR flows, numbers and AI voice agents — with signed webhooks, consent built in and every request safe to retry.
Your servers manage contacts and their consent; send WhatsApp templates and replies, SMS and email; order numbers and answer their calls with a call flow, your own application or an AI agent; place calls to your own voice agent, a flow, an AI agent or your team; act on live calls; and hear about every delivery, reply and call outcome through signed webhooks — without handling Meta's tokens or a carrier's.
- Send a WhatsApp templateFrom an API key to a delivered message in a few minutes.
- Receive webhooksRegister an endpoint, verify the signature, handle events.
- API referenceEvery endpoint, parameter and response, with samples in six languages.
- SDKs and PostmanTyped clients for Node.js, Python and Go, and a Postman collection.
What you can build
| Product | What the API does today |
|---|---|
| Approved templates any time with consent; text, media, buttons, lists and reactions inside the 24-hour window; replies on any thread; hosted onboarding for your customers' numbers. | |
| SMS | DLT-registered templates in India from your registered headers, consent by TRAI category, the promotional window enforced. |
| Templates or HTML from your own verified domain, with suppressions, bounces and complaints handled. | |
| Calls | Place a call run by your own agent over a WebSocket, by a call flow or by one of your AI agents, or bridged to a number or a desk agent (customer first, or agent first); answering-machine detection, recordings, hang-ups and call events. |
| Call control and conferences | On a live call: speak, play, gather key presses or speech, send DTMF, hold and resume, transfer to a number, a queue, a flow or an application, pause the recording, hang up — or open the call to more parties. |
| Call flows and inbound calls | Versioned IVRs — menus, speech gathers, business hours, queues, voicemail and an AI agent as a step — that answer your numbers or run outbound calls; or your own answer URL. |
| Numbers | Search, order and release numbers paid from your prepaid credit, route their calls, register them as SMS senders, and port your own numbers in. |
| AI agents | Voice agents with their own instructions, voice and tools your servers answer, data extracted from every call, and each call's transcript and AI summary over the API. |
| Queues | Call queues for your team's desk: members, tiers and skills, hold audio and overflow. |
| Contacts and consent | One contact per phone number, consent per channel with evidence, export and erasure for data requests. |
| Broadcasts | One approved template to an audience — by tags, attributes or ids — now or at a set time. |
| Verify and Lookup | One-time codes by SMS, WhatsApp, a voice call or email; a phone number's validity, type and India do-not-call status. |
The basics
| Topic | In short |
|---|---|
| Base URL | https://api.trovacast.com |
| Projects | Your workspace in the console is a project; the API calls it an organization (organizationId). |
| Authentication | Authorization: Bearer tc_live_… — API keys, each with its own scopes. |
| Format | JSON in and out, camelCase, timestamps in ISO 8601 UTC. |
| Lists | Cursor-paginated as { data, nextCursor } — Pagination. |
| Errors | A stable code beside every message; branch on the code — Errors. |
| Retries | Every write accepts an Idempotency-Key — Idempotency. |
| Limits | 600 requests a minute per key, reported in X-RateLimit-* headers — Rate limits. |
| Contract | GET /v1/openapi.json (OpenAPI 3) — what the reference, SDKs and Postman collection are generated from. |
| Changes | Additive only within v1 — Versioning, Changelog. |
Built for compliance
- Consent, the WhatsApp service window, DLT rules, suppressions and the template's current category are checked when a message is sent, not only when it is queued.
- A project key sees one project; another project's records answer
404. Phone numbers are masked to their last four digits on reads. - Export everything held about a contact, or erase it for good — media, recordings and stored payloads included — with one call each. See Data requests.
- Webhook payloads are signed, retried for about three days and readable for 30.
Get a key
A project administrator creates keys in the Trovacast console under Settings → Developers, choosing exactly what each may do. New to Trovacast? Talk to us to open an account.