# AgentPhone Create Agent

> AgentPhone Create Agent is a paid API for AI agents from AgentPhone at mpp.orthogonal.com, paid per call via MPP, $0.005/call, status unknown (last checked 2026-10-10, last successful call 2026-07-11).

Creates a new AI phone agent with a specified name, voice, system prompt, and voice mode for making and receiving calls.

## Facts

- Endpoint: POST https://mpp.orthogonal.com/agentphone/v1/agents?utm_source=zero.xyz
- Price: $0.005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-07-11
- Success rate: 100% of calls made through Zero
- Activations on Zero: 2
- Provider: AgentPhone
- Docs: https://api.agentphone.ai
- Website: https://api.agentphone.ai
- Tags: phone, voice, sms, calls, social
- Canonical page: https://www.zero.xyz/c/agentphone-create-agent-826caf8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3402mxt6_LeDRnZ1HFlZI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentphone-create-agent-826caf8c -d '<json body>'
```

Example prompt: Set up a new AgentPhone agent called 'SupportBot' using a friendly female ElevenLabs voice, with voice mode set to conversational, and a system prompt that says: 'You are a helpful customer support agent for Acme Corp. Answer questions politely and escalate complex issues.'

## When to prefer this

Use this endpoint when you need to create a new AI voice/phone agent from scratch with a specific identity, voice, and behavioral instructions. This is the first step before assigning a phone number or initiating calls via AgentPhone.

## Known failure modes

- Invalid or unrecognized voice ID returns 400 or 422 error
- Missing required fields (name, system prompt) returns validation error
- Unauthorized request if API key is missing or invalid returns 401
- Voice mode value not in accepted enum returns 422
- Duplicate agent name may return conflict error depending on enforcement

## How this service works

Create a new agent with name, voice, system prompt, and voice mode.

## Output

Returns the newly created agent's ID and configuration details including name, voice, system prompt, and voice mode, which can then be used to assign a phone number and make or receive calls.

## Example request

```json
{
 "name": "TestSupportAgent",
 "voice": "ElevenLabs_Female_Friendly",
 "voice_mode": "conversational",
 "system_prompt": "You are a helpful customer support agent. Answer questions politely and escalate complex issues when needed."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentphone-create-agent-826caf8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.orthogonal.com](https://www.zero.xyz/host/mpp.orthogonal.com/llms.txt)