Initiate a Leadping phone call

curl --request POST \
  --url https://api.leadping.ai/phone-call/initiate \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromPhoneNumberId": "<string>",
  "conversationId": "<string>",
  "leadId": "<string>",
  "wasManuallyOverridden": true,
  "campaignId": "<string>",
  "sourceId": "<string>",
  "outboundIdempotencyKey": "<string>"
}
'

import requests

url = "https://api.leadping.ai/phone-call/initiate"

payload = {
    "fromPhoneNumberId": "<string>",
    "conversationId": "<string>",
    "leadId": "<string>",
    "wasManuallyOverridden": True,
    "campaignId": "<string>",
    "sourceId": "<string>",
    "outboundIdempotencyKey": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://api.leadping.ai/phone-call/initiate");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

HttpResponse<String> response = Unirest.post("https://api.leadping.ai/phone-call/initiate")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}")
  .asString();

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    fromPhoneNumberId: '<string>',
    conversationId: '<string>',
    leadId: '<string>',
    wasManuallyOverridden: true,
    campaignId: '<string>',
    sourceId: '<string>',
    outboundIdempotencyKey: '<string>'
  })
};

fetch('https://api.leadping.ai/phone-call/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadping.ai/phone-call/initiate"

	payload := strings.NewReader("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadping.ai/phone-call/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromPhoneNumberId' => '<string>',
    'conversationId' => '<string>',
    'leadId' => '<string>',
    'wasManuallyOverridden' => true,
    'campaignId' => '<string>',
    'sourceId' => '<string>',
    'outboundIdempotencyKey' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusReason": "<string>",
  "direction": "<string>",
  "conversationId": "<string>",
  "leadId": "<string>",
  "phoneNumber": "<string>",
  "toPhoneNumber": "<string>",
  "fromPhoneNumberId": "<string>",
  "fromPhoneNumber": "<string>",
  "callerId": "<string>",
  "wasManuallyOverridden": true,
  "campaignId": "<string>",
  "sourceId": "<string>",
  "endedAt": "2023-11-07T05:31:56Z",
  "queuedAt": "2023-11-07T05:31:56Z",
  "ringingAt": "2023-11-07T05:31:56Z",
  "answeredAt": "2023-11-07T05:31:56Z",
  "durationSeconds": 123,
  "billingStatus": "<string>",
  "billableAmount": 123,
  "recordingUrl": "<string>",
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

POST

phone-call

initiate

Initiate a Leadping phone call

curl --request POST \
  --url https://api.leadping.ai/phone-call/initiate \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromPhoneNumberId": "<string>",
  "conversationId": "<string>",
  "leadId": "<string>",
  "wasManuallyOverridden": true,
  "campaignId": "<string>",
  "sourceId": "<string>",
  "outboundIdempotencyKey": "<string>"
}
'

import requests

url = "https://api.leadping.ai/phone-call/initiate"

payload = {
    "fromPhoneNumberId": "<string>",
    "conversationId": "<string>",
    "leadId": "<string>",
    "wasManuallyOverridden": True,
    "campaignId": "<string>",
    "sourceId": "<string>",
    "outboundIdempotencyKey": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://api.leadping.ai/phone-call/initiate");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

HttpResponse<String> response = Unirest.post("https://api.leadping.ai/phone-call/initiate")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}")
  .asString();

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    fromPhoneNumberId: '<string>',
    conversationId: '<string>',
    leadId: '<string>',
    wasManuallyOverridden: true,
    campaignId: '<string>',
    sourceId: '<string>',
    outboundIdempotencyKey: '<string>'
  })
};

fetch('https://api.leadping.ai/phone-call/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadping.ai/phone-call/initiate"

	payload := strings.NewReader("{\n  \"fromPhoneNumberId\": \"<string>\",\n  \"conversationId\": \"<string>\",\n  \"leadId\": \"<string>\",\n  \"wasManuallyOverridden\": true,\n  \"campaignId\": \"<string>\",\n  \"sourceId\": \"<string>\",\n  \"outboundIdempotencyKey\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadping.ai/phone-call/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromPhoneNumberId' => '<string>',
    'conversationId' => '<string>',
    'leadId' => '<string>',
    'wasManuallyOverridden' => true,
    'campaignId' => '<string>',
    'sourceId' => '<string>',
    'outboundIdempotencyKey' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "statusReason": "<string>",
  "direction": "<string>",
  "conversationId": "<string>",
  "leadId": "<string>",
  "phoneNumber": "<string>",
  "toPhoneNumber": "<string>",
  "fromPhoneNumberId": "<string>",
  "fromPhoneNumber": "<string>",
  "callerId": "<string>",
  "wasManuallyOverridden": true,
  "campaignId": "<string>",
  "sourceId": "<string>",
  "endedAt": "2023-11-07T05:31:56Z",
  "queuedAt": "2023-11-07T05:31:56Z",
  "ringingAt": "2023-11-07T05:31:56Z",
  "answeredAt": "2023-11-07T05:31:56Z",
  "durationSeconds": 123,
  "billingStatus": "<string>",
  "billableAmount": 123,
  "recordingUrl": "<string>",
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>"
}

Body

The call initiation request containing phone number and optional metadata.

Defines the fields clients can send when working with phone call initiation.

fromPhoneNumberId

null | string

Sender phone number ID used for this outbound SMS or call.

conversationId

null | string

Conversation ID that links this phone call initiation request to the Leadping inbox thread.

leadId

string

Lead ID associated with the outbound call request.

wasManuallyOverridden

boolean

Indicates whether a user manually overrode Leadping's automatic number selection for this phone call initiation request.

campaignId

null | string

Messaging campaign identifier associated with this phone call initiation request.

sourceId

null | string

Lead source ID used for call attribution and sender selection.

outboundIdempotencyKey

null | string

Idempotency key used to prevent duplicate outbound delivery.

Response

Calls was successfully initiated.

Describes a Leadping phone call, including participants, direction, provider state, timing, recording, and billing details.

status

enum<string>

Current lifecycle status for this phone call in the Leadping API.

Available options:

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

statusReason

null | string

Human-readable reason explaining the current status of this phone call.

direction

null | string

Communication direction for this phone call, such as inbound or outbound.

conversationId

null | string

Conversation ID that links this phone call to the Leadping inbox thread.

leadId

null | string

Lead ID associated with the call conversation or outreach attempt.

phoneNumber

string

Phone number used by this phone call for calls, SMS, lookup, or routing.

toPhoneNumber

null | string

Recipient phone number used for this communication.

fromPhoneNumberId

null | string

Sender phone number ID used for this outbound SMS or call.

fromPhoneNumber

null | string

Sender phone number used for this communication.

callerId

null | string

Caller ID phone number presented during the outbound call.

selectionReason

null | enum<string>

Defines the supported Outgoing Number Selection Reason values.

Available options:

StickyConversation,

LeadAssigned,

CampaignOrSource,

Preferred,

LocalArea,

HealthyPool,

FallbackDefault,

ManualOverride

wasManuallyOverridden

boolean

Indicates whether a user manually overrode Leadping's automatic number selection for this phone call.

campaignId

null | string

Messaging campaign identifier associated with this phone call.

sourceId

null | string

Lead source ID used for attribution and routing on this call.

endedAt

null | string<date-time>

UTC timestamp when the call ended.

queuedAt

null | string<date-time>

UTC timestamp when Leadping queued this phone call for processing.

ringingAt

null | string<date-time>

UTC timestamp when the call started ringing.

answeredAt

null | string<date-time>

UTC timestamp when the call was answered.

durationSeconds

Call duration in seconds.

billingStatus

null | string

Billing state for this communication, charge, or transaction.

billableAmount

Monetary amount billed for this Leadping communication or transaction.

recordingUrl

null | string

URL for the call recording, when the provider makes one available.

string

The unique identifier for the entity.

createdAt

string<date-time>

The date and time when the entity was created.

modifiedAt

null | string<date-time>

The date and time when the entity was last modified, if applicable.

Last modified on August 11, 2026

API Overview

Endpoints

Initiate a Leadping phone call

Body

Response