Leads

Update an organization lead record and status

Updates lead details for the current organization, keeping contact data, status, source, and follow-up context current.

put/leads/{id}

Request

  • Base URL: https://api.leadping.ai
  • URL: https://api.leadping.ai/leads/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The ID of the lead to update.

Request body

enabledboolean nullable

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

tagIdsstring[] required

Tag IDs assigned to or filtered against this lead.

tagNamesstring[] required

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

idstring nullable

Response

Lead was successfully updated.

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.

processingStatus'Quarantined' | 'Verifying' | 'Validating' | 'Enriching' | 'Ready' | 'Invalid' | 'Failed' nullable

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.