# Hellou AI Calls API

**Canonical:** https://apis.io/apis/hellou-ai/hellou-ai-calls-api/  
**Provider:** Hellou AI — https://apis.io/providers/hellou-ai/  
**Base URL:** https://one.hellou.ai  
**Documentation:** https://one.hellou.ai/docs/api

Hellou AI Calls API is one of 47 APIs that [Hellou AI](https://apis.io/providers/hellou-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Calls. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Call history: who called whom, when, for how long, and how it ended -- WhatsApp calls and the phone calls AI agents answer, with what was said on an AI call. History is read-only. A person's call is placed on the phone line or on WhatsApp; both endpoints place a real call and are not available to AI agents or MCP clients.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/accounts/{account_id}/whatsapp_calls/initiate` | Call a contact on WhatsApp |
| POST | `/api/v1/accounts/{account_id}/porta/calls` | Call a contact on the phone line |
| GET | `/api/v1/accounts/{account_id}/porta/live_status` | Live status of every phone extension |
| GET | `/api/v1/accounts/{account_id}/porta/activity_metrics` | Today's call metrics for the wallboard |
| GET | `/api/v1/accounts/{account_id}/calls` | List calls |
| GET | `/api/v1/accounts/{account_id}/call_history` | List call history |
| GET | `/api/v1/accounts/{account_id}/calls/{id}` | Get a call |
| GET | `/api/v1/accounts/{account_id}/calls/{id}/transcript` | Get an AI call's transcript |
| GET | `/api/v1/accounts/{account_id}/calls/{id}/recording` | Play a call's recording |
| POST | `/api/v1/accounts/{account_id}/calls/{id}/take_over` | Take over a live AI call |
| GET | `/api/v1/accounts/{account_id}/softphone_session` | Whether the in-app softphone is available |
| POST | `/api/v1/accounts/{account_id}/softphone_session` | Start an in-app softphone session |
| DELETE | `/api/v1/accounts/{account_id}/softphone_session` | End the in-app softphone session |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hellou-ai/openapi/hellou-ai-calls-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-ai-call-report-schema.json
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-voice-campaign-schema.json
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-voice-campaign-report-stats-schema.json
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-inbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-voice-campaign-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hellou-ai/json-schema/hellou-ai-call-schema.json

## Other Hellou AI APIs (12)

- [Hellou AI Account AgentBots API](https://apis.io/apis/hellou-ai/hellou-ai-account-agentbots-api/)
- [Hellou AI Account Users API](https://apis.io/apis/hellou-ai/hellou-ai-account-users-api/)
- [Hellou AI Accounts API](https://apis.io/apis/hellou-ai/hellou-ai-accounts-api/)
- [Hellou AI Agent Bots API](https://apis.io/apis/hellou-ai/hellou-ai-agentbots-api/)
- [Hellou AI Agents API](https://apis.io/apis/hellou-ai/hellou-ai-agents-api/)
- [Hellou AI AI Classifications API](https://apis.io/apis/hellou-ai/hellou-ai-ai-classifications-api/)
- [Hellou AI AI Phone Lines API](https://apis.io/apis/hellou-ai/hellou-ai-ai-phone-lines-api/)
- [Hellou AI Assignment Settings API](https://apis.io/apis/hellou-ai/hellou-ai-assignment-settings-api/)
- [Hellou AI Automation Rule API](https://apis.io/apis/hellou-ai/hellou-ai-automation-rule-api/)
- [Hellou AI Campaigns API](https://apis.io/apis/hellou-ai/hellou-ai-campaigns-api/)
- [Hellou AI Canned Responses API](https://apis.io/apis/hellou-ai/hellou-ai-canned-responses-api/)
- [Hellou AI Connectors API](https://apis.io/apis/hellou-ai/hellou-ai-connectors-api/)

## Tags

Calls

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hellou-ai/hellou-ai-calls-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hellou-ai/.