POST /api/v1/calls
{
"to": "+256700000000",
"type": "remind",
"voice": "tara",
"message": "Your appointment is tomorrow at 10 AM."
}
FOR DEVELOPERS
Build with TaraAI
Integrate Tara into your product with a clean REST API. Trigger calls, receive responses, and automate workflows without standing up a voice stack.
- ✓ RESTful APIs
- ✓ Webhooks & real-time events
- ✓ Comprehensive documentation
- ✓ Sandbox for testing
WHAT YOU CAN AUTOMATE
Trigger a call. Receive the meaning. Update your product.
Outbound calls
Create a reminder, verification, or collection call with a destination number, service, language preference, and template or dynamic prompt.
Conversation webhooks
When a call ends, receive intent, entities, confidence, detected languages, and the actions Tara executed or asked to confirm.
Business actions
Map PAYMENT_COMMITMENT, CONFIRM_APPOINTMENT, or REQUEST_HUMAN_AGENT to your own records. Sensitive actions wait for confirmation.
Provider-agnostic by design
TaraAI does not hard-code one speech or LLM vendor into Tara. Your integration talks to TaraAI. Behind Tara, speech-to-text, language detection, understanding, text-to-speech, and telecom providers can be swapped independently.
- • SpeechToTextProvider
- • LanguageDetectionProvider
- • AIUnderstandingProvider
- • TextToSpeechProvider
- • TelecomProvider
POST /api/v1/calls
{
"to": "+256700000000",
"service": "collect",
"language": "lg",
"contact": {
"name": "John",
"timezone": "Africa/Kampala"
},
"context": {
"account_ref": "LN-2041"
}
}
Webhook example
{
"intent": "PAYMENT_COMMITMENT",
"commitment_date": "2026-09-11",
"languages": ["lg", "en"],
"confidence": 0.96,
"action": "promise_to_pay"
}
FAQ
API questions
- Do we need to send audio ourselves?
- No. Tara owns the phone call. You send who to call and why. You receive structured understanding when the conversation completes or when a human is needed.
- Is language sent as a country code?
- No. Country and language are separate. Send a preferred language if you have one. Tara can still detect what the customer actually spoke.
- How are credits billed for API calls?
- The same AI Credits wallet as the dashboard. Buy credits once, then use them from the app or the API.
Ready to reach customers across Africa?
Give Tara a number. She’ll call in their language.