Leads

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.

post/leads/intake

Request

Base URL: https://api.leadping.ai
URL: https://api.leadping.ai/leads/intake
Auth: HTTP bearer

Request body

idempotencyKeystring nullable

Stable delivery key reused when retrying the same lead submission to this source.

firstNamestring nullable

First name of the lead, user, or contact represented by this lead intake request.

lastNamestring nullable

Last name of the lead, user, or contact represented by this lead intake request.

emailstring email nullable

Email address for the person represented by this lead intake request.

phonestring nullable

Phone details for the lead, user, or organization represented by this lead intake request.

phoneTypestring nullable

Source-provided phone type, such as mobile, landline, or VoIP, used during lead intake normalization.

dateOfBirthstring date nullable

Lead date of birth supplied by intake sources and normalized into the lead profile.

birthDatestring date nullable

Lead birth date used for demographic matching and insurance intake workflows.

address1string nullable

First street address line submitted by the lead intake source.

address2string nullable

Second street address line submitted by the lead intake source.

citystring nullable

City for the lead or organization postal address.

statestring nullable

State, province, or region for the lead or organization postal address.

zipstring nullable

ZIP code submitted by the lead intake source.

postalCodestring nullable

Postal code for the lead or organization address.

genderstring nullable

Lead gender supplied by intake sources and normalized when possible.

subIdstring nullable

Affiliate or publisher sub ID captured for lead attribution.

sellerLeadIdstring nullable

Seller-provided lead identifier used to deduplicate and reconcile lead delivery.

sellerLeadIdentifierstring nullable

Alternate seller-provided lead identifier used during intake normalization.

directPostPricenumber double nullable

Direct-post price supplied by the lead source during intake.

pricenumber double nullable

Lead price or transaction price supplied to the Leadping API.

utmSourcestring nullable

UTM source parameter captured for lead attribution reporting.

utmMediumstring nullable

UTM medium parameter captured for lead attribution reporting.

utmCampaignstring nullable

UTM campaign parameter captured for lead attribution reporting.

utmTermstring nullable

UTM term parameter captured for lead attribution reporting.

utmContentstring nullable

UTM content parameter captured for lead attribution reporting.

productstring nullable

Product or offer associated with the lead or source.

verticalstring nullable

Industry vertical used for lead routing, compliance review, and reporting.

referrerstring nullable

Referring page or traffic source that sent the lead into Leadping.

landingPagestring nullable

Landing page URL where the lead submitted their information.

trustedFormUrlstring uri nullable

TrustedForm certificate URL used as proof of consumer consent.

externalIdstring nullable

External system identifier used to reconcile this lead intake request across integrations.

sourceMetadataobject nullable

Source-provided key-value metadata retained for lead attribution and integration troubleshooting.

tagIdsstring[]

Tag IDs assigned to or filtered against this lead.

tagNamesstring[]

Tag names assigned to this lead when matching existing tags by name.

Example request

{
  "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"
  ]
}

Response

The lead response was created successfully.

isDemoboolean

assignedToUserIdstring nullable

Leadping user currently responsible for this lead, or null when it is in the unassigned queue.

enabledboolean

Indicates whether this lead response is active and available in the Leadping API.

deletedAtstring date-time nullable

UTC timestamp when this lead was soft deleted.

deletedByUserIdstring nullable

User ID of the person who soft deleted this lead.

archivedAtstring date-time nullable

UTC timestamp when this record was archived.

archivedByUserIdstring nullable

User ID of the person who archived this record.

archiveReason0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 nullable

Defines why a lead was removed from the active working pipeline.

archiveNotestring nullable

Optional note explaining why the lead was archived.

isArchivedboolean

Indicates whether the lead has been archived in Leadping.

Defines the asynchronous verification and enrichment lifecycle for a lead.

processingStatusReasonstring nullable

Explanation when asynchronous lead processing is blocked or fails.

processingStatusChangedAtstring date-time nullable

UTC timestamp when the processing stage last changed.

idstring

createdAtstring date-time

modifiedAtstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.