> ## Documentation Index > Fetch the complete documentation index at: https://docs.langcall.com/llms.txt > Use this file to discover all available pages before exploring further. # Create New Call > Create a new phone call ## Voice ID The voice ID is the identifier of the voice model to use for the call. You can refer to the below tables to find the voice ID for your preferred voice. ### Low-latency and human-like AI voices | ID | Text | | --------------- | ------------------------ | | aura-asteria-en | Asteria, American female | | aura-athena-en | Athena, British female | | aura-luna-en | Luna, American female | | aura-stella-en | Stella, American female | | aura-helios-en | Helios, British male | | aura-orion-en | Orion, American male | | aura-orpheus-en | Orpheus, American male | ### Ultra-high quality AI voices | ID | Text | Preview | | -------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | EXAVITQu4vr4xnSDxMaL | Sarah, American female, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/EXAVITQu4vr4xnSDxMaL/01a3e33c-6e99-4ee7-8543-ff2216a32186.mp3) | | FGY2WhTYpPnrIDTdsKH5 | Laura, American female, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/FGY2WhTYpPnrIDTdsKH5/67341759-ad08-41a5-be6e-de12fe448618.mp3) | | IKne3meq5aSn9XLyUdCD | Charlie, Australian male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/IKne3meq5aSn9XLyUdCD/102de6f2-22ed-43e0-a1f1-111fa75c5481.mp3) | | JBFqnCBsd6RMkjVDRZzb | George, British male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/JBFqnCBsd6RMkjVDRZzb/e6206d1a-0721-4787-aafb-06a6e705cac5.mp3) | | N2lVS1w4EtoT3dr4eOWO | Callum, Transatlantic male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/N2lVS1w4EtoT3dr4eOWO/ac833bd8-ffda-4938-9ebc-b0f99ca25481.mp3) | | TX3LPaxmHKxFdv7VOQHJ | Liam, American male, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/TX3LPaxmHKxFdv7VOQHJ/63148076-6363-42db-aea8-31424308b92c.mp3) | | XB0fDUnXU5powFXDhCwa | Charlotte, Swedish female, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/XB0fDUnXU5powFXDhCwa/942356dc-f10d-4d89-bda5-4f8505ee038b.mp3) | | Xb7hH8MSUJpSbSDYk0k2 | Alice, British female, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/Xb7hH8MSUJpSbSDYk0k2/d10f7534-11f6-41fe-a012-2de1e482d336.mp3) | | XrExE9yKIg1WjnnlVkGX | Matilda, American female, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/XrExE9yKIg1WjnnlVkGX/b930e18d-6b4d-466e-bab2-0ae97c6d8535.mp3) | | bIHbv24MWmeRgasZH58o | Will, American male, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/bIHbv24MWmeRgasZH58o/8caf8f3d-ad29-4980-af41-53f20c72d7a4.mp3) | | cgSgspJ2msm6clMCkdW9 | Jessica, American female, young | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/cgSgspJ2msm6clMCkdW9/56a97bf8-b69b-448f-846c-c3a11683d45a.mp3) | | cjVigY5qzO86Huf0OWal | Eric, American male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/cjVigY5qzO86Huf0OWal/d098fda0-6456-4030-b3d8-63aa048c9070.mp3) | | iP95p4xoKVk53GoZ742B | Chris, American male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/iP95p4xoKVk53GoZ742B/3f4bde72-cc48-40dd-829f-57fbf906f4d7.mp3) | | nPczCjzI2devNBz1zQrb | Brian, American male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/nPczCjzI2devNBz1zQrb/2dd3e72c-4fd3-42f1-93ea-abc5d4e5aa1d.mp3) | | onwK4e9ZLuTAKqWW03F9 | Daniel, British male, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/onwK4e9ZLuTAKqWW03F9/7eee0236-1a72-4b86-b303-5dcadc007ba9.mp3) | | pFZP5JQG7iQjIQuC4Bku | Lily, British female, middle-aged | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/pFZP5JQG7iQjIQuC4Bku/89b68b35-b3dd-4348-a84a-a3c13a3c2b30.mp3) | | pqHfZKP75CvOlQylNhV4 | Bill, American male, old | [Preview](https://storage.googleapis.com/eleven-public-prod/premade/voices/pqHfZKP75CvOlQylNhV4/d782b3ff-84ba-4029-848c-acf01285524d.mp3) | ## Status Callback The status callback is a webhook URL that will be called when the call status is updated. The URL must be publicly accessible and accept a POST request with a JSON body. The `status_callback` parameter is optional. If you don't specify it, the call will not be updated. If you specify it, the call will be updated with the following events: | Event | Description | | --------- | ---------------------------------------------------------------------------------------------------------------------------- | | initiated | The AI call starts dialing. | | ringing | The call starts ringing. | | answered | The call is answered. If this event is specified, LangCall will send an in-progress status. | | completed | The call is completed, regardless of the termination status (which can be busy, cancelled, completed, failed, or no-answer). | LangCall will send a POST request to the URL with the following JSON body: ```json theme={null} "id": "ID123", "type": "full_ai", "to_number": "+1234567890", "instruction": "inform the user that he has a meeting tomorrow at 6pm", "transfer_number": null, "voice_id": "aura-asteria-en", "created_at": "2024-09-25T22:22:08.095646+00:00", "direction": "outbound", "duration": 1, "status": "completed", "status_callback": "https://webhook.site/123456789", "conversations": [{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi, this is Jason, I'm calling to let you know that you have a meeting tomorrow at 6pm."}] ``` ## OpenAPI ````yaml POST /v1/calls openapi: 3.0.1 info: title: LangCall API description: LangCall APIs Specification license: name: MIT version: 1.0.0 servers: - url: https://api.langcall.com security: - bearerAuth: [] paths: /v1/calls: post: description: Create a new phone call requestBody: description: Data required to initiate an AI call content: application/json: schema: $ref: '#/components/schemas/NewCall' required: true responses: '200': description: call response content: application/json: schema: $ref: '#/components/schemas/Call' '400': description: unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: NewCall: required: - type - to_number - instruction type: object properties: type: type: string enum: - full_ai - transfer description: Type of the call example: full_ai to_number: type: string description: >- Number to call. Phone numbers should be formatted in [E.164](https://www.twilio.com/docs/glossary/what-e164) format with a + and country code, for example: `+16175551212`. example: '+1234567890' instruction: type: string description: Detailed instruction for the call example: Get a home loan certificate and send it to a@a.com transfer_number: type: string description: >- Required if the call type is “transfer.” If you need to include an extension, separate the number and extension with a comma. For example: `+0987654321,123`. example: '+0987654321' voice_id: type: string description: 'Voice ID to use for the call. ' example: aura-asteria-en status_callback: type: string nullable: true description: 'Webhook URL to be called when the call status is updated. ' example: https://webhook.site/97f897b1-288d-4772-9a6e-11111 Call: allOf: - type: object properties: id: description: Identification number of the call type: string created_at: description: >- Time when the call was started in ISO 8601 standard, e.g. `2024-09-25T22:22:08.095646+00:00` type: string direction: enum: - inbound - outbound description: 'Direction of the call: inbound or outbound' type: string duration: description: Duration of the call in minutes type: number conversations: description: A list of messages comprising the phone conversation so far type: array items: $ref: '#/components/schemas/Message' - $ref: '#/components/schemas/NewCall' Error: required: - message type: object properties: message: type: string Message: type: object properties: role: type: string enum: - assistant - user description: 'Role of the message ' content: type: string description: Transcription of the conversation securitySchemes: bearerAuth: type: http scheme: bearer ````