> ## Documentation Index > Fetch the complete documentation index at: https://docs.itellico.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create call > Create a public call resource for either an outbound SIP phone call or a web call. Web calls also return a short-lived LiveKit join token. ## OpenAPI ````yaml https://api.itellico.ai/v1/openapi.json post /v1/accounts/{account_id}/calls openapi: 3.1.0 info: title: itellicoAI API v1 version: 1.0.0 description: >- Public REST API for managing accounts, agents, telephony resources, and conversations. Authentication is via API key in the `X-API-Key` header. termsOfService: https://itellico.ai/legal/terms-and-conditions/ contact: name: itellicoAI Support email: support@itellico.ai license: name: Proprietary servers: - url: https://api.itellico.ai description: Production security: - APIKeyAuth: [] tags: - name: Accounts description: >- Identify the current account context and fetch core account metadata to bootstrap API usage. - name: Subaccounts description: >- Create and manage child accounts under a parent to model tenant hierarchies and delegated access. - name: Agents description: >- Define and configure conversational agents (model, transcriber, voice, behavior) used in calls and automations. - name: Providers description: >- Discover available AI model, transcriber, and voice catalogs for the current account when configuring agents. - name: Phone Numbers description: >- Manage BYOC phone numbers bound to your account; route inbound calls to agents and enable outbound calling. - name: SIP Trunks description: >- Manage BYOC SIP trunk connectivity (origination/termination endpoints and allowed IPs) used by phone numbers. - name: Calls description: >- Create, list, inspect, and connect voice calls across phone and web channels. - name: Conversations description: List and inspect conversation activity across web and telephony channels. - name: Analytics description: Usage analytics and reporting endpoints for conversation activity. paths: /v1/accounts/{account_id}/calls: post: tags: - Calls summary: Create call description: >- Create a public call resource for either an outbound SIP phone call or a web call. Web calls also return a short-lived LiveKit join token. operationId: createCall parameters: - in: path name: account_id schema: format: uuid4 title: Account Id type: string required: true requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateCallDTO' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/CallStartV1Out' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '502': description: Bad Gateway content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' security: - APIKeyAuth: [] components: schemas: CreateCallDTO: properties: type: description: >- Call type. Use `phone` for outbound SIP and `web` for browser-based calls. enum: - phone - web title: Type type: string agent_id: description: Agent UUID title: Agent Id type: string from_number: anyOf: - type: string - type: 'null' description: Source E.164 phone number for phone calls title: From Number to_number: anyOf: - type: string - type: 'null' description: Destination E.164 phone number for phone calls title: To Number medium: anyOf: - type: string - type: 'null' description: Optional compatibility field. `web` calls always use WEB. title: Medium device_fingerprint: anyOf: - type: string - type: 'null' description: Optional client/device fingerprint for web calls title: Device Fingerprint external_id: anyOf: - type: string - type: 'null' description: Optional idempotency/correlation key title: External Id initial_text: anyOf: - type: string - type: 'null' description: Optional first user message injected into web call context title: Initial Text audio_input_enabled: anyOf: - type: boolean - type: 'null' title: Audio Input Enabled audio_output_enabled: anyOf: - type: boolean - type: 'null' title: Audio Output Enabled amd: anyOf: - enum: - livekit - tool - aculab - none type: string - type: 'null' description: >- Answering-machine detection for phone calls: livekit, tool, aculab, or none. title: Amd skip_greeting_on_initial_text: anyOf: - type: boolean - type: 'null' title: Skip Greeting On Initial Text test_variables: anyOf: - additionalProperties: true type: object - type: 'null' description: Optional runtime variables exposed to the call worker title: Test Variables overrides: anyOf: - additionalProperties: true type: object - type: 'null' description: >- Optional runtime override object. Use `overrides.agent` with the same JSON shape as Agent PATCH (/v1/accounts/{account_id}/agents/{agent_id}). title: Overrides required: - type - agent_id title: CreateCallDTO type: object CallStartV1Out: properties: id: format: uuid4 title: Id type: string type: title: Type type: string direction: anyOf: - type: string - type: 'null' title: Direction status: title: Status type: string answer_status: anyOf: - $ref: '#/components/schemas/ConversationAnswerStatus' - type: 'null' description: >- How the call was answered when known (`waiting`, `human`, `machine`, `user_rejected`, `user_unavailable`, `user_busy`, or `unknown`). agent_id: anyOf: - format: uuid4 type: string - type: 'null' title: Agent Id agent_name: anyOf: - type: string - type: 'null' title: Agent Name from_number: anyOf: - type: string - type: 'null' title: From Number to_number: anyOf: - type: string - type: 'null' title: To Number external_id: anyOf: - type: string - type: 'null' title: External Id created: format: date-time title: Created type: string modified: format: date-time title: Modified type: string started_at: anyOf: - format: date-time type: string - type: 'null' title: Started At ended_at: anyOf: - format: date-time type: string - type: 'null' title: Ended At duration_seconds: anyOf: - type: integer - type: 'null' title: Duration Seconds success: default: true title: Success type: boolean join: anyOf: - $ref: '#/components/schemas/CallJoinV1Out' - type: 'null' required: - id - type - status - created - modified title: CallStartV1Out type: object ErrorSchema: description: |- Standard error response payload for all API endpoints. Follows industry best practices (similar to Stripe, RetellAI): - code: Machine-readable error identifier for programmatic handling - message: Human-readable description for display - detail: Optional additional context for debugging - errors: Optional list of field-level validation errors examples: - code: not_found detail: Agent with UUID 123e4567-e89b-12d3-a456-426614174000 does not exist message: Resource not found - code: validation_error errors: - field: body.email message: Invalid email format type: value_error - field: body.name message: Field required type: missing message: Validation failed properties: code: description: Machine-readable error code (e.g., 'not_found', 'validation_error') title: Code type: string message: description: Human-readable error message title: Message type: string detail: anyOf: - type: string - type: 'null' description: Optional detailed context for debugging title: Detail errors: anyOf: - items: $ref: '#/components/schemas/FieldErrorSchema' type: array - type: 'null' description: Field-level validation errors (for 422 responses) title: Errors required: - code - message title: ErrorSchema type: object ConversationAnswerStatus: description: Public answer status values for voice calls. enum: - waiting - human - machine - user_rejected - user_unavailable - user_busy - unknown title: ConversationAnswerStatus type: string CallJoinV1Out: description: LiveKit connection details returned for web calls. properties: token: title: Token type: string livekit_url: title: Livekit Url type: string room_sid: title: Room Sid type: string required: - token - livekit_url - room_sid title: CallJoinV1Out type: object FieldErrorSchema: description: Schema for individual field validation errors. properties: field: description: Field path (e.g., 'body.name', 'query.page') title: Field type: string message: description: Human-readable error message title: Message type: string type: description: Error type (e.g., 'value_error', 'type_error') title: Type type: string required: - field - message - type title: FieldErrorSchema type: object securitySchemes: APIKeyAuth: type: apiKey in: header name: X-API-Key ````