RESTful APIs, SDKs, and webhooks to integrate AI voice and messaging agents into your applications. Ship faster with comprehensive docs and examples.
1# Initiate an outbound call2curl --request POST \3 --url https://demo.mindhunters.ai/api/v1/call \4 --header 'Authorization: Bearer <token>' \5 --header 'Content-Type: application/json' \6 --data '{7 "agentId": "32d8fc98-be1e-4d32-...",8 "participant": {9 "number": "+1 (415) 555-0123",10 "about": "Customer John Doe"11 }12 }'
1import requests23url = "https://demo.mindhunters.ai/api/v1/call"4headers = {5 "Authorization": "Bearer <token>",6 "Content-Type": "application/json"7}8data = {9 "agentId": "32d8fc98-be1e-4d32-...",10 "participant": {"number": "+1 (415) 555-0123"}11}12response = requests.post(url, headers=headers, json=data)
1const response = await fetch(2 'https://demo.mindhunters.ai/api/v1/call',3 {4 method: 'POST',5 headers: {6 'Authorization': 'Bearer <token>',7 'Content-Type': 'application/json'8 },9 body: JSON.stringify({10 agentId: '32d8fc98-be1e-4d32-...',11 participant: { number: '+1 (415) 555-0123' }12 })13 }14);
Get started with the Mihu AI API in three simple steps.
Sign in to your dashboard and generate a private API token with optional expiration.
All API requests are made to our secure endpoint with your bearer token.
Initiate an outbound call with your agent and start automating conversations.
Choose between API keys for server-to-server or OAuth 2.0 for user-delegated access.
Generate API keys to authenticate your requests. Create private tokens with optional expiration dates for secure access.
Industry-standard authorization for user-delegated access. Perfect for marketplace integrations.
Send users to Mihu's consent screen
GET /oauth/authorize?client_id=...
User grants permission, you get a code
?code=abc123&state=xyz
Trade the code for an access token
POST /oauth/token
Explore our RESTful API with detailed request/response examples for every endpoint.
Initiates an outbound call using a specified AI agent. The agent will call the participant number and follow the configured prompt instructions.
| Parameter | Type | Required | Description |
|---|---|---|---|
| agentId | string | Required | UUID of the AI agent to use for the call |
| participant.number | string | Required | Phone number to call (E.164 format) |
| participant.about | string | Optional | Context about the participant for the AI |
| prompt.content | string | Optional | Custom prompt to override agent's default |
| prompt.overwrite | boolean | Optional | Whether to overwrite default prompt |
| message.start | string | Optional | Opening message when call connects |
{
"agentId": "32d8fc98-be1e-4d32-a12e-146f397fb1cb",
"prompt": {
"overwrite": true,
"content": "You are Michael from the support team..."
},
"participant": {
"number": "+1 (415) 555-0123",
"about": "Customer named John Doe. Order #12345."
},
"message": {
"start": "Hello! This is Michael from support."
}
}
{
"success": true,
"message": "Operation completed successfully",
"data": {
"callId": "call_abc123def456",
"status": "initiated"
}
}
Set up Webhooks to trigger actions on external services in real-time. Stay informed on updates and changes to ensure seamless integration.
{
"event": "conversation.end_report",
"timestamp": "2024-01-15T14:32:18Z",
"data": {
"conversation_id": "conv_abc123def456",
"agent_id": "32d8fc98-be1e-4d32-a12e-146f397fb1cb",
"direction": "outbound",
"participant": {
"number": "+1 (415) 555-0123",
"name": "John Doe"
},
"duration_seconds": 187,
"status": "completed",
"transcript_url": "https://...",
"recording_url": "https://...",
"sentiment": "positive",
"summary": "Customer inquired about order status..."
}
}
Get your API key and ship your first integration in minutes. Free tier includes 1,000 API calls per month.