Skip to main content
DELETE
Delete lead label

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

The ID of the item to delete

Example:

"019f7ffb-d8d8-7087-a31b-3dbedcc5f843"

Body

application/json
reassigned_status
number

The interest status to reassign leads and emails to.

Example:

1

Response

The deleted Lead Label

A custom label for categorizing and managing leads

id
string<uuid>
required
read-only

Unique identifier for the custom lead label

Example:

"019f7ffb-b638-7bc1-94e9-3797f971a5e7"

timestamp_created
string<date-time>
required
read-only

Timestamp when the custom lead label was created

Example:

"2026-07-20T14:43:50.456Z"

created_by
string<uuid>
required
read-only

User ID of the creator of this label

Example:

"019f7ffb-b638-7bc1-94e9-37988630942e"

organization_id
string<uuid>
required
read-only

Organization ID that owns this custom lead label

Example:

"019f7ffb-b638-7bc1-94e9-37994e3b2bc8"

label
string
required

Display label for the custom lead label

Example:

"Hot Lead"

interest_status_label
enum<string>
required

Interest status label associated with this label

Available options:
positive,
negative,
neutral
Example:

"positive"

interest_status
number
required
read-only

Interest status associated with this label. This is generated automatically by us.

Example:

1

description
null | string

Detailed description of the custom lead label purpose

Example:

"Used for marking high-priority leads"

use_with_ai
null | boolean

Whether this label should be used with AI features

Example:

false