retell_create_phone_number
Register a new phone number for Retell AI agents to handle inbound and outbound calls using specified area codes.
Instructions
Register/purchase a new phone number for use with Retell AI agents.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area_code | Yes | The area code for the phone number (e.g., '415' for San Francisco) | |
| inbound_agent_id | No | Optional: Agent ID to handle inbound calls to this number | |
| outbound_agent_id | No | Optional: Agent ID to use for outbound calls from this number | |
| nickname | No | Optional: A friendly name for the phone number |
Implementation Reference
- src/index.ts:1153-1154 (handler)The handler logic for the retell_create_phone_number tool, which proxies the request to the Retell API endpoint /create-phone-number via retellRequest.case "retell_create_phone_number": return retellRequest("/create-phone-number", "POST", args);
- src/index.ts:313-338 (schema)The tool definition including name, description, and input schema, used for both registration in the tools list and validation.{ name: "retell_create_phone_number", description: "Register/purchase a new phone number for use with Retell AI agents.", inputSchema: { type: "object", properties: { area_code: { type: "string", description: "The area code for the phone number (e.g., '415' for San Francisco)" }, inbound_agent_id: { type: "string", description: "Optional: Agent ID to handle inbound calls to this number" }, outbound_agent_id: { type: "string", description: "Optional: Agent ID to use for outbound calls from this number" }, nickname: { type: "string", description: "Optional: A friendly name for the phone number" } }, required: ["area_code"] } },