Skip to main content
This schema describes objects returned by the Lead Label endpoints.
A custom label for categorizing and managing leads

Fields

FieldTypeRequiredDescription
idstring (uuid)YesUnique identifier for the custom lead label (read-only)
timestamp_createdstring (date-time)YesTimestamp when the custom lead label was created (read-only)
created_bystring (uuid)YesUser ID of the creator of this label (read-only)
organization_idstring (uuid)YesOrganization ID that owns this custom lead label (read-only)
labelstringYesDisplay label for the custom lead label
interest_status_labelstringYesInterest status label associated with this label. Possible values: positive (Positive), negative (Negative), neutral (Neutral)
interest_statusnumberYesInterest status associated with this label. This is generated automatically by us. (read-only)
descriptionstring, nullableNoDetailed description of the custom lead label purpose
use_with_aiboolean, nullableNoWhether this label should be used with AI features