Skip to content
Docs

List Lead LabelsBeta

List the workspace's lead labels, sorted by name.

GET/api/v1/lead-labels

Lead labels are workspace-defined (at most 100) and sit next to the built-in reply categories. A label is put on a lead, and the lead's labels array shows it.

Response#

dataarray
Show Label object
idstring
Label id.
namestring
Label name, unique per workspace ignoring case.
colorstring
Color token: neutral, brand, success, warning, error or info.
meaningstring
positive, neutral or negative. Informational; it does not affect sending.
createdAtstring
ISO 8601 timestamp.

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026