Skip to main content
POST
Create an organization lead status

Body

The lead status name, color, and display order to create.

Defines the editable values used to create or update a lead status.

name
null | string

Display name for the lead status.

color
null | string

Display color for the lead status.

category
null | enum<string>

Controlled lead status change categories used for reporting, automation, and analytics.

Available options:
Open,
Qualified,
Converted,
Lost,
Invalid,
Duplicate
sortOrder

Relative display order for the lead status.

Response

The newly created lead status.

Represents a configurable status that can be assigned to leads.

id
string

Unique identifier for the lead status.

organizationId
string

Identifier of the organization that owns the lead status.

name
string

Display name of the lead status.

color
string

Display color assigned to the lead status.

category
enum<string>

LeadStatusChange category represented by the lead status.

Available options:
Open,
Qualified,
Converted,
Lost,
Invalid,
Duplicate
sortOrder

Relative display order of the lead status.

isArchived
boolean

Indicates whether the lead status has been archived.

modifiedAt
string<date-time>

Date and time when the lead status was last modified.

Last modified on August 11, 2026