curl --request POST \
--url https://api.leadping.ai/leads/intake \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "Taylor",
"lastName": "Morgan",
"email": "taylor@example.com",
"phone": "+13125550100",
"utmSource": "paid-search",
"utmCampaign": "summer-campaign",
"landingPage": "https://example.com/request-a-quote",
"externalId": "external-lead-123",
"tagNames": [
"website",
"new-lead"
]
}
'import requests
url = "https://api.leadping.ai/leads/intake"
payload = {
"firstName": "Taylor",
"lastName": "Morgan",
"email": "taylor@example.com",
"phone": "+13125550100",
"utmSource": "paid-search",
"utmCampaign": "summer-campaign",
"landingPage": "https://example.com/request-a-quote",
"externalId": "external-lead-123",
"tagNames": ["website", "new-lead"]
}
headers = {
"Authorization": "Bearer <token>",
"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/leads/intake");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.post("https://api.leadping.ai/leads/intake")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}")
.asString();const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'Taylor',
lastName: 'Morgan',
email: 'taylor@example.com',
phone: '+13125550100',
utmSource: 'paid-search',
utmCampaign: 'summer-campaign',
landingPage: 'https://example.com/request-a-quote',
externalId: 'external-lead-123',
tagNames: ['website', 'new-lead']
})
};
fetch('https://api.leadping.ai/leads/intake', 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/leads/intake"
payload := strings.NewReader("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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/leads/intake",
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([
'firstName' => 'Taylor',
'lastName' => 'Morgan',
'email' => 'taylor@example.com',
'phone' => '+13125550100',
'utmSource' => 'paid-search',
'utmCampaign' => 'summer-campaign',
'landingPage' => 'https://example.com/request-a-quote',
'externalId' => 'external-lead-123',
'tagNames' => [
'website',
'new-lead'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"isDemo": true,
"assignedToUserId": "<string>",
"assignedTo": {
"id": "<string>",
"name": "<string>"
},
"metadata": {
"sourceName": "<string>",
"organizationName": "<string>",
"intakeIdempotencyKey": "<string>",
"capturedAt": "2023-11-07T05:31:56Z",
"captureIpAddress": "<string>",
"captureUserAgent": "<string>",
"currency": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"referrer": "<string>",
"landingPage": "<string>",
"subId": "<string>",
"pubId": "<string>",
"ipAddress": "<string>",
"userAgent": "<string>",
"externalId": "<string>",
"sellerLeadId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"price": 123,
"directPostPrice": 123,
"product": "<string>",
"vertical": "<string>",
"complianceStatus": "<string>",
"complianceBlockedReason": "<string>",
"sourceMetadata": {},
"origin": "<string>",
"importBatchId": "<string>",
"isImported": true,
"assignedPhoneNumberId": "<string>",
"smsConsentStatus": "<string>",
"smsOptedOut": true,
"smsOptOutAt": "2023-11-07T05:31:56Z",
"smsOptInAt": "2023-11-07T05:31:56Z",
"smsHelpRequestedAt": "2023-11-07T05:31:56Z",
"smsConsentPhoneNumber": "<string>",
"consentCertificateUrl": "<string>",
"consentCertificateType": "TrustedForm",
"consentAttested": true,
"consentValidationSkippedAt": "2023-11-07T05:31:56Z",
"consentVerificationStatus": "Verified",
"trustedFormCheckedAt": "2023-11-07T05:31:56Z",
"trustedFormRejectedAt": "2023-11-07T05:31:56Z",
"leadpingConsentCheckedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>"
},
"contact": {
"firstName": "<string>",
"lastName": "<string>",
"streetAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"state": "<string>",
"province": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"additionalInfo": "<string>"
},
"coordinate": {
"latitude": 123,
"longitude": 123
},
"timeZoneId": "<string>",
"phone": {
"phoneIdentityId": "<string>",
"number": "<string>",
"type": "<string>"
},
"email": "jsmith@example.com",
"avatarUrl": "<string>"
},
"phoneIdentity": {
"isDemo": true,
"number": "<string>",
"lookup": {
"number": "<string>",
"nationalFormat": "<string>",
"recordType": "<string>",
"fraud": "<string>",
"isValid": true,
"lineType": "Wireline",
"carrier": {
"mobileCountryCode": "<string>",
"mobileNetworkCode": "<string>",
"name": "<string>",
"normalizedCarrier": "<string>",
"type": "FixedLine",
"errorCode": "<string>"
},
"callerName": {
"name": "<string>",
"errorCode": "<string>"
},
"portability": {
"alternativeSpid": "<string>",
"alternativeCarrierName": "<string>",
"alternativeCarrierType": "<string>",
"city": "<string>",
"lineType": "<string>",
"localRoutingNumber": "<string>",
"operatingCompanyNumber": "<string>",
"portedDate": "<string>",
"portedStatus": "<string>",
"spid": "<string>",
"carrierName": "<string>",
"carrierType": "<string>",
"state": "<string>"
},
"location": {
"location": "<string>",
"state": "<string>",
"canonicalCity": "<string>",
"canonicalState": "<string>",
"countryCode": "<string>",
"coordinate": {
"latitude": 123,
"longitude": 123
},
"coordinateSource": {
"method": "<string>",
"query": "<string>"
},
"timeZoneId": "<string>",
"timeZoneSource": {
"method": "<string>",
"query": "<string>"
}
},
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
},
"providerEnrichment": {
"provider": "<string>",
"lookupType": "<string>",
"schemaVersion": 123,
"retrievedAt": "2023-11-07T05:31:56Z",
"rawRecordJson": "<string>"
},
"lastEnrichedAt": "2023-11-07T05:31:56Z",
"lookupActions": [
{
"id": "<string>",
"type": "validation",
"provider": "<string>",
"status": "succeeded",
"occurredAt": "2023-11-07T05:31:56Z",
"providerCostAmount": 123,
"providerPricingVersion": "<string>"
}
],
"name": "<string>",
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
},
"profile": {
"gender": "M",
"birthDate": "2023-12-25",
"qualification": {
"height": 123,
"weight": 123,
"maritalStatus": "Married",
"income": 123,
"isHomeowner": true,
"monthsAtResidence": 123,
"creditScore": 123,
"hasBankruptcy": true,
"employmentType": "Employed",
"numberOfDependents": 123,
"hasMedicalCondition": true,
"incomeCurrency": "<string>"
}
},
"inquiry": {
"service": "<string>",
"description": "<string>",
"budgetMinimum": 123,
"budgetMaximum": 123,
"currency": "<string>",
"desiredStartDate": "2023-12-25",
"urgency": "Flexible"
},
"company": {
"name": "<string>",
"website": "<string>",
"jobTitle": "<string>",
"industry": "<string>",
"employeeCount": 123
},
"serviceAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"state": "<string>",
"province": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"additionalInfo": "<string>"
},
"contactPreferences": {
"language": "<string>",
"channel": "Email",
"callbackWindows": [
{
"date": "2023-12-25",
"start": "<string>",
"end": "<string>"
}
]
},
"customFields": {},
"enabled": true,
"deletedAt": "2023-11-07T05:31:56Z",
"deletedByUserId": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"archivedByUserId": "<string>",
"archiveReason": 0,
"archiveNote": "<string>",
"isArchived": true,
"currentLeadStatus": {
"revision": 123,
"followUpCompletedAt": "2023-11-07T05:31:56Z",
"followUpDueAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"category": "Open",
"outcome": "<string>",
"displayName": "<string>",
"changedAt": "2023-11-07T05:31:56Z",
"changedByUserId": "<string>",
"changedByAutomationId": "<string>",
"source": "User"
},
"processingStatus": "Quarantined",
"processingStatusReason": "<string>",
"processingStatusChangedAt": "2023-11-07T05:31:56Z",
"tags": [
{
"id": "<string>",
"name": "<string>",
"normalizedName": "<string>",
"color": "<string>"
}
],
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
}{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Unauthorized",
"status": 401,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Forbidden",
"status": 403,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Too Many Requests",
"status": 429,
"detail": "The request could not be completed."
}Create a lead record from intake payload
Creates a source-authenticated lead from a flat intake payload, capturing contact fields, metadata, and automation-ready lead details.
curl --request POST \
--url https://api.leadping.ai/leads/intake \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "Taylor",
"lastName": "Morgan",
"email": "taylor@example.com",
"phone": "+13125550100",
"utmSource": "paid-search",
"utmCampaign": "summer-campaign",
"landingPage": "https://example.com/request-a-quote",
"externalId": "external-lead-123",
"tagNames": [
"website",
"new-lead"
]
}
'import requests
url = "https://api.leadping.ai/leads/intake"
payload = {
"firstName": "Taylor",
"lastName": "Morgan",
"email": "taylor@example.com",
"phone": "+13125550100",
"utmSource": "paid-search",
"utmCampaign": "summer-campaign",
"landingPage": "https://example.com/request-a-quote",
"externalId": "external-lead-123",
"tagNames": ["website", "new-lead"]
}
headers = {
"Authorization": "Bearer <token>",
"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/leads/intake");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.post("https://api.leadping.ai/leads/intake")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}")
.asString();const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: 'Taylor',
lastName: 'Morgan',
email: 'taylor@example.com',
phone: '+13125550100',
utmSource: 'paid-search',
utmCampaign: 'summer-campaign',
landingPage: 'https://example.com/request-a-quote',
externalId: 'external-lead-123',
tagNames: ['website', 'new-lead']
})
};
fetch('https://api.leadping.ai/leads/intake', 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/leads/intake"
payload := strings.NewReader("{\n \"firstName\": \"Taylor\",\n \"lastName\": \"Morgan\",\n \"email\": \"taylor@example.com\",\n \"phone\": \"+13125550100\",\n \"utmSource\": \"paid-search\",\n \"utmCampaign\": \"summer-campaign\",\n \"landingPage\": \"https://example.com/request-a-quote\",\n \"externalId\": \"external-lead-123\",\n \"tagNames\": [\n \"website\",\n \"new-lead\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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/leads/intake",
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([
'firstName' => 'Taylor',
'lastName' => 'Morgan',
'email' => 'taylor@example.com',
'phone' => '+13125550100',
'utmSource' => 'paid-search',
'utmCampaign' => 'summer-campaign',
'landingPage' => 'https://example.com/request-a-quote',
'externalId' => 'external-lead-123',
'tagNames' => [
'website',
'new-lead'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"isDemo": true,
"assignedToUserId": "<string>",
"assignedTo": {
"id": "<string>",
"name": "<string>"
},
"metadata": {
"sourceName": "<string>",
"organizationName": "<string>",
"intakeIdempotencyKey": "<string>",
"capturedAt": "2023-11-07T05:31:56Z",
"captureIpAddress": "<string>",
"captureUserAgent": "<string>",
"currency": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"referrer": "<string>",
"landingPage": "<string>",
"subId": "<string>",
"pubId": "<string>",
"ipAddress": "<string>",
"userAgent": "<string>",
"externalId": "<string>",
"sellerLeadId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"price": 123,
"directPostPrice": 123,
"product": "<string>",
"vertical": "<string>",
"complianceStatus": "<string>",
"complianceBlockedReason": "<string>",
"sourceMetadata": {},
"origin": "<string>",
"importBatchId": "<string>",
"isImported": true,
"assignedPhoneNumberId": "<string>",
"smsConsentStatus": "<string>",
"smsOptedOut": true,
"smsOptOutAt": "2023-11-07T05:31:56Z",
"smsOptInAt": "2023-11-07T05:31:56Z",
"smsHelpRequestedAt": "2023-11-07T05:31:56Z",
"smsConsentPhoneNumber": "<string>",
"consentCertificateUrl": "<string>",
"consentCertificateType": "TrustedForm",
"consentAttested": true,
"consentValidationSkippedAt": "2023-11-07T05:31:56Z",
"consentVerificationStatus": "Verified",
"trustedFormCheckedAt": "2023-11-07T05:31:56Z",
"trustedFormRejectedAt": "2023-11-07T05:31:56Z",
"leadpingConsentCheckedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>"
},
"contact": {
"firstName": "<string>",
"lastName": "<string>",
"streetAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"state": "<string>",
"province": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"additionalInfo": "<string>"
},
"coordinate": {
"latitude": 123,
"longitude": 123
},
"timeZoneId": "<string>",
"phone": {
"phoneIdentityId": "<string>",
"number": "<string>",
"type": "<string>"
},
"email": "jsmith@example.com",
"avatarUrl": "<string>"
},
"phoneIdentity": {
"isDemo": true,
"number": "<string>",
"lookup": {
"number": "<string>",
"nationalFormat": "<string>",
"recordType": "<string>",
"fraud": "<string>",
"isValid": true,
"lineType": "Wireline",
"carrier": {
"mobileCountryCode": "<string>",
"mobileNetworkCode": "<string>",
"name": "<string>",
"normalizedCarrier": "<string>",
"type": "FixedLine",
"errorCode": "<string>"
},
"callerName": {
"name": "<string>",
"errorCode": "<string>"
},
"portability": {
"alternativeSpid": "<string>",
"alternativeCarrierName": "<string>",
"alternativeCarrierType": "<string>",
"city": "<string>",
"lineType": "<string>",
"localRoutingNumber": "<string>",
"operatingCompanyNumber": "<string>",
"portedDate": "<string>",
"portedStatus": "<string>",
"spid": "<string>",
"carrierName": "<string>",
"carrierType": "<string>",
"state": "<string>"
},
"location": {
"location": "<string>",
"state": "<string>",
"canonicalCity": "<string>",
"canonicalState": "<string>",
"countryCode": "<string>",
"coordinate": {
"latitude": 123,
"longitude": 123
},
"coordinateSource": {
"method": "<string>",
"query": "<string>"
},
"timeZoneId": "<string>",
"timeZoneSource": {
"method": "<string>",
"query": "<string>"
}
},
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
},
"providerEnrichment": {
"provider": "<string>",
"lookupType": "<string>",
"schemaVersion": 123,
"retrievedAt": "2023-11-07T05:31:56Z",
"rawRecordJson": "<string>"
},
"lastEnrichedAt": "2023-11-07T05:31:56Z",
"lookupActions": [
{
"id": "<string>",
"type": "validation",
"provider": "<string>",
"status": "succeeded",
"occurredAt": "2023-11-07T05:31:56Z",
"providerCostAmount": 123,
"providerPricingVersion": "<string>"
}
],
"name": "<string>",
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
},
"profile": {
"gender": "M",
"birthDate": "2023-12-25",
"qualification": {
"height": 123,
"weight": 123,
"maritalStatus": "Married",
"income": 123,
"isHomeowner": true,
"monthsAtResidence": 123,
"creditScore": 123,
"hasBankruptcy": true,
"employmentType": "Employed",
"numberOfDependents": 123,
"hasMedicalCondition": true,
"incomeCurrency": "<string>"
}
},
"inquiry": {
"service": "<string>",
"description": "<string>",
"budgetMinimum": 123,
"budgetMaximum": 123,
"currency": "<string>",
"desiredStartDate": "2023-12-25",
"urgency": "Flexible"
},
"company": {
"name": "<string>",
"website": "<string>",
"jobTitle": "<string>",
"industry": "<string>",
"employeeCount": 123
},
"serviceAddress": {
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"state": "<string>",
"province": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"additionalInfo": "<string>"
},
"contactPreferences": {
"language": "<string>",
"channel": "Email",
"callbackWindows": [
{
"date": "2023-12-25",
"start": "<string>",
"end": "<string>"
}
]
},
"customFields": {},
"enabled": true,
"deletedAt": "2023-11-07T05:31:56Z",
"deletedByUserId": "<string>",
"archivedAt": "2023-11-07T05:31:56Z",
"archivedByUserId": "<string>",
"archiveReason": 0,
"archiveNote": "<string>",
"isArchived": true,
"currentLeadStatus": {
"revision": 123,
"followUpCompletedAt": "2023-11-07T05:31:56Z",
"followUpDueAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"category": "Open",
"outcome": "<string>",
"displayName": "<string>",
"changedAt": "2023-11-07T05:31:56Z",
"changedByUserId": "<string>",
"changedByAutomationId": "<string>",
"source": "User"
},
"processingStatus": "Quarantined",
"processingStatusReason": "<string>",
"processingStatusChangedAt": "2023-11-07T05:31:56Z",
"tags": [
{
"id": "<string>",
"name": "<string>",
"normalizedName": "<string>",
"color": "<string>"
}
],
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z"
}{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Unauthorized",
"status": 401,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Forbidden",
"status": 403,
"detail": "The request could not be completed."
}{
"type": "about:blank",
"title": "Too Many Requests",
"status": 429,
"detail": "The request could not be completed."
}Authorizations
Leadping source key for lead ingestion endpoints only using the Authorization header. Example: "Authorization: Bearer lp_src_...".
Body
The common lead fields submitted by the external system.
Defines the fields clients can send when working with lead intake.
Stable delivery key reused when retrying the same lead submission to this source.
First name of the lead, user, or contact represented by this lead intake request.
Last name of the lead, user, or contact represented by this lead intake request.
Email address for the person represented by this lead intake request.
Contact phone number. Use E.164 with a leading + for international numbers.
Source-provided phone type, such as mobile, landline, or VoIP, used during lead intake normalization.
Lead date of birth supplied by intake sources and normalized into the lead profile.
Lead birth date used for demographic matching and insurance intake workflows.
First street address line submitted by the lead intake source.
Second street address line submitted by the lead intake source.
City for the lead or organization postal address.
State, province, or region for the lead or organization postal address.
ZIP code submitted by the lead intake source.
Postal code for the lead or organization address.
Lead gender supplied by intake sources and normalized when possible.
Affiliate or publisher sub ID captured for lead attribution.
Seller-provided lead identifier used to deduplicate and reconcile lead delivery.
Alternate seller-provided lead identifier used during intake normalization.
Alias for price. When both are supplied, their amounts must agree.
Lead price or transaction price supplied to the Leadping API.
UTM source parameter captured for lead attribution reporting.
UTM medium parameter captured for lead attribution reporting.
UTM campaign parameter captured for lead attribution reporting.
UTM term parameter captured for lead attribution reporting.
UTM content parameter captured for lead attribution reporting.
Product or offer associated with the lead or source.
Industry vertical used for lead routing, compliance review, and reporting.
Referring page or traffic source that sent the lead into Leadping.
Landing page URL where the lead submitted their information.
Certificate URL used as proof of consumer consent.
The provider responsible for a lead's consent certificate.
TrustedForm, Leadping, Other Explicitly attests to SMS consent when consentCertificateType is Other. Allows manual texts only.
External system identifier used to reconcile this lead intake request across integrations.
Source-provided key-value metadata retained for lead attribution and integration troubleshooting.
Show child attributes
Show child attributes
Tag IDs assigned to or filtered against this lead.
Tag names assigned to this lead when matching existing tags by name.
The service or purchase requested by a lead.
Show child attributes
Show child attributes
Business represented by a lead contact.
Show child attributes
Show child attributes
Describes a physical or mailing address using international locality, administrative-area, postal-code, and country fields.
Show child attributes
Show child attributes
Preferred contact language, channel, and callback windows; does not grant consent.
Show child attributes
Show child attributes
Industry-specific JSON scalar or scalar-array answers; keys are stable field identifiers.
Public Leadping API schema for lead demographic profile data.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 contact address country code.
Contact time zone identifier.
Publisher identifier.
Original source capture timestamp.
Original visitor IP as reported by the source.
Original visitor user agent as reported by the source.
ISO 4217 acquisition price currency.
Response
The lead response was created successfully.
Describes lead data returned by Leadping.
Leadping user currently responsible for this lead, or null when it is in the unassigned queue.
Provides a compact API reference to another resource using its stable identifier and human-readable display name.
Show child attributes
Show child attributes
Public Leadping API schema for lead attribution metadata data.
Show child attributes
Show child attributes
Public Leadping API schema for lead contact profile data.
Show child attributes
Show child attributes
Describes Leadping's canonical identity for a phone number, including normalization, carrier, line type, reputation, and lookup history.
Show child attributes
Show child attributes
Public Leadping API schema for lead demographic profile data.
Show child attributes
Show child attributes
The service or purchase requested by a lead.
Show child attributes
Show child attributes
Business represented by a lead contact.
Show child attributes
Show child attributes
Describes a physical or mailing address using international locality, administrative-area, postal-code, and country fields.
Show child attributes
Show child attributes
Preferred contact language, channel, and callback windows; does not grant consent.
Show child attributes
Show child attributes
Industry-specific JSON scalar or scalar-array answers; keys are stable field identifiers.
Whether the lead is enabled.
UTC timestamp when this lead was soft deleted.
User ID of the person who soft deleted this lead.
UTC timestamp when this record was archived.
User ID of the person who archived this record.
Defines why a lead was removed from the active working pipeline.
0, 1, 2, 3, 4, 5, 6, 7, 8, 9 Optional note explaining why the lead was archived.
Indicates whether the lead has been archived in Leadping.
Summary schema for Leadping API current lead status change summary data used in dashboards and reports.
Show child attributes
Show child attributes
Defines the asynchronous verification and enrichment lifecycle for a lead.
Quarantined, Verifying, Validating, Enriching, Ready, Invalid, Failed Explanation when asynchronous lead processing is blocked or fails.
UTC timestamp when the processing stage last changed.
Tags currently attached to this lead, source, or record.
Show child attributes
Show child attributes
Stable unique identifier of the resource.
UTC timestamp when the resource was created.
UTC timestamp when the resource was last modified, or null when it has not been updated.