> ## Documentation Index > Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Initiate a Leadping phone call > Starts an outbound Leadping phone call for an authenticated user and returns the provider call identifiers, status, and routing details. ## OpenAPI ````yaml /openapi.json post /phone-call/initiate openapi: 3.1.1 info: title: Leadping API description: >- Leadping API for lead intake, messaging, calling, automations, billing, organization settings, and compliant lead communication workflows. license: name: MIT url: https://opensource.org/licenses/MIT version: v1 servers: - url: https://api.leadping.ai description: Production security: [] tags: - name: Analytics - name: Automations - name: Contact - name: Conversations - name: Feedback - name: Leads - name: LeadStatusChanges - name: LeadStatuses - name: Notifications - name: OutboundDelivery - name: Sources - name: Suppressions - name: Tags - name: Users - name: Calls - name: PhoneNumbers - name: Sms - name: Telephony - name: Organizations - name: UserDataExports - name: CallEvents - name: Events - name: SmsEvents - name: PaymentMethods - name: Transactions - name: Usage - name: Wallets paths: /phone-call/initiate: post: tags: - Calls summary: Initiate a Leadping phone call description: >- Starts an outbound Leadping phone call for an authenticated user and returns the provider call identifiers, status, and routing details. operationId: Calls_InitiateCall requestBody: description: >- The call initiation request containing phone number and optional metadata. content: application/json: schema: allOf: - $ref: '#/components/schemas/InitiateCallRequest' description: >- Defines the fields clients can send when working with phone call initiation. application/*+json: schema: allOf: - $ref: '#/components/schemas/InitiateCallRequest' description: >- Defines the fields clients can send when working with phone call initiation. required: true responses: '200': description: Calls was successfully initiated. content: application/json: schema: allOf: - $ref: '#/components/schemas/PhoneCallResponse' description: >- Describes a Leadping phone call, including participants, direction, provider state, timing, recording, and billing details. '400': description: The request was invalid or malformed. content: application/json: schema: allOf: - $ref: '#/components/schemas/ProblemDetails' description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. '401': description: Unauthorized content: application/json: schema: allOf: - $ref: '#/components/schemas/ProblemDetails' description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. components: schemas: InitiateCallRequest: type: object properties: fromPhoneNumberId: type: - 'null' - string description: Sender phone number ID used for this outbound SMS or call. conversationId: type: - 'null' - string description: >- Conversation ID that links this phone call initiation request to the Leadping inbox thread. leadId: type: string description: Lead ID associated with the outbound call request. wasManuallyOverridden: type: boolean description: >- Indicates whether a user manually overrode Leadping's automatic number selection for this phone call initiation request. campaignId: type: - 'null' - string description: >- Messaging campaign identifier associated with this phone call initiation request. sourceId: type: - 'null' - string description: Lead source ID used for call attribution and sender selection. outboundIdempotencyKey: type: - 'null' - string description: Idempotency key used to prevent duplicate outbound delivery. description: >- Defines the fields clients can send when working with phone call initiation. PhoneCallResponse: type: object properties: status: allOf: - $ref: '#/components/schemas/PhoneCallStatus' description: Current lifecycle status for this phone call in the Leadping API. statusReason: type: - 'null' - string description: >- Human-readable reason explaining the current status of this phone call. direction: type: - 'null' - string description: >- Communication direction for this phone call, such as inbound or outbound. conversationId: type: - 'null' - string description: >- Conversation ID that links this phone call to the Leadping inbox thread. leadId: type: - 'null' - string description: Lead ID associated with the call conversation or outreach attempt. phoneNumber: type: string description: >- Phone number used by this phone call for calls, SMS, lookup, or routing. toPhoneNumber: type: - 'null' - string description: Recipient phone number used for this communication. fromPhoneNumberId: type: - 'null' - string description: Sender phone number ID used for this outbound SMS or call. fromPhoneNumber: type: - 'null' - string description: Sender phone number used for this communication. callerId: type: - 'null' - string description: Caller ID phone number presented during the outbound call. selectionReason: enum: - StickyConversation - LeadAssigned - CampaignOrSource - Preferred - LocalArea - HealthyPool - FallbackDefault - ManualOverride type: - 'null' - string description: Defines the supported Outgoing Number Selection Reason values. wasManuallyOverridden: type: boolean description: >- Indicates whether a user manually overrode Leadping's automatic number selection for this phone call. campaignId: type: - 'null' - string description: Messaging campaign identifier associated with this phone call. sourceId: type: - 'null' - string description: Lead source ID used for attribution and routing on this call. endedAt: type: - 'null' - string description: UTC timestamp when the call ended. format: date-time queuedAt: type: - 'null' - string description: UTC timestamp when Leadping queued this phone call for processing. format: date-time ringingAt: type: - 'null' - string description: UTC timestamp when the call started ringing. format: date-time answeredAt: type: - 'null' - string description: UTC timestamp when the call was answered. format: date-time durationSeconds: pattern: ^-?(?:0|[1-9]\d*)$ type: - 'null' - integer - string description: Call duration in seconds. format: int32 billingStatus: type: - 'null' - string description: Billing state for this communication, charge, or transaction. billableAmount: pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$ type: - 'null' - number - string description: >- Monetary amount billed for this Leadping communication or transaction. format: double recordingUrl: type: - 'null' - string description: URL for the call recording, when the provider makes one available. id: type: string description: The unique identifier for the entity. createdAt: type: string description: The date and time when the entity was created. format: date-time modifiedAt: type: - 'null' - string description: The date and time when the entity was last modified, if applicable. format: date-time description: >- Describes a Leadping phone call, including participants, direction, provider state, timing, recording, and billing details. ProblemDetails: type: object properties: type: type: - 'null' - string description: URI reference that identifies the problem type. title: type: - 'null' - string description: Short, human-readable summary of the problem. status: pattern: ^-?(?:0|[1-9]\d*)$ type: - 'null' - integer - string description: HTTP status code returned for the problem. format: int32 detail: type: - 'null' - string description: >- Human-readable explanation specific to this occurrence of the problem. instance: type: - 'null' - string description: >- URI reference that identifies this specific occurrence of the problem. description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. PhoneCallStatus: enum: - scheduled - queued - initiated - ringing - in_progress - active - completed - ended - busy - no_answer - failed - canceled - missed - transferred - voicemail - blocked_billing - blocked_phone_number_status - blocked_configuration - blocked_permission - configuration_required type: string description: Defines the supported Phone Call Status values. ````