Leads

Update a lead property

Change how a custom property is compared when filtering (type), or whether it shows as a column in the leads table. Stored values are not changed.

PATCH

/api/v1/lead-properties/{key}

Path parameters

key

required

string

Property key

Request bodyrequired

typeoptional

"string" | "number" | "boolean" | "date"

How values are compared when filtering. Values are always stored as text; the type is guessed from the first value seen and can be changed.

showAsColumnoptional

boolean

Show this property as a column in the leads table.

Response

200The updated property.

property

object

key

string

Property key. Filter on it as properties.<key>.

type

"string" | "number" | "boolean" | "date"

How values are compared when filtering. Values are always stored as text; the type is guessed from the first value seen and can be changed.

showAsColumn

boolean

Shown as a column in the leads table.

leadCount

integer

Leads with a non-empty value.

topValues

object[]

Up to 5 most common values, most common first.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy