Developers

REST API & webhooks for AMBITION AI

Base URL

https://app.ambitnhouse.com/api

Endpoints

GET/agentsList all agents

POST/agentsCreate an agent

GET/agents/:idGet one agent

PUT/agents/:idUpdate an agent

POST/twilio/outbound-callStart an outbound call

POST/batch-callsStart a batch of calls

GET/callsList call history

GET/calls/:idGet a call with transcript & analysis

GET/calls/analyticsAggregate analytics

POST/contactsCreate a contact

Start an outbound call

curl

curl -X POST https://app.ambitnhouse.com/api/twilio/outbound-call \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+34600000000",
    "from_number": "+13158183970",
    "agent_id": "your-agent-id"
  }'

Post-call webhook

Set a Webhook URL on any agent. When a call finishes and is analyzed, this JSON is POSTed to it.

POST body

{
  "event": "call_analyzed",
  "call_id": "e3b0c...",
  "agent_id": "d3e8c...",
  "agent_name": "Receptionist",
  "from_number": "+34600000000",
  "direction": "inbound",
  "transcript": [ { "role": "user", "content": "..." } ],
  "summary": "Caller booked an appointment for Tuesday.",
  "sentiment": "positive",
  "call_successful": true,
  "custom_data": { "appointment_date": "Tue 3pm" },
  "recording_url": "/api/calls/e3b0c.../recording"
}