Skip to main content
PATCH
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Path Parameters

id
string
required

The unique identifier of the lead to update, starting with 'lead_'.

Example:

"lead_xxxxxxxxxxxxx"

Body

application/json

Parameters for UpdateLead

metadata
object | null

A JSON object of custom metadata to set on the lead, replacing any existing metadata.

referrer
string | null

The updated referral URL for the lead, such as 'https://example.com/landing'.

Response

A successful response

A prospective customer who has expressed interest in a company or product but has not yet purchased.

created_at
string<date-time>
required

The datetime the lead was created.

Example:

"2023-12-01T05:00:00.401Z"

id
string
required

The unique identifier for the lead.

Example:

"lead_xxxxxxxxxxxxx"

member
object | null
required

The company member record if this lead has converted into a paying customer. Null if the lead has not converted.

metadata
object | null
required

Custom key-value pairs attached to this lead. Null if no metadata was provided.

product
object | null
required

The product the lead expressed interest in. Null if the lead is not associated with a specific product.

referrer
string | null
required

The URL of the page that referred this lead to the company. Null if no referrer was captured.

Example:

"https://twitter.com/whabormarket"

updated_at
string<date-time>
required

The datetime the lead was last updated.

Example:

"2023-12-01T05:00:00.401Z"

user
object
required

The user account associated with this lead.