> ## Documentation Index
> Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an organization lead status

> Creates a reusable lead status for the current organization to categorize, organize, and track leads consistently throughout its sales and follow-up workflow.



## OpenAPI

````yaml /openapi.json post /lead-statuses
openapi: 3.1.1
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    organization settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Feedback
  - name: Leads
  - name: LeadStatusChanges
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: Organizations
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /lead-statuses:
    post:
      tags:
        - LeadStatuses
      summary: Create an organization lead status
      description: >-
        Creates a reusable lead status for the current organization to
        categorize, organize, and track leads consistently throughout its sales
        and follow-up workflow.
      operationId: LeadStatuses_Create
      requestBody:
        description: The lead status name, color, and display order to create.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/LeadStatusRequest'
              description: >-
                Defines the editable values used to create or update a lead
                status.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/LeadStatusRequest'
              description: >-
                Defines the editable values used to create or update a lead
                status.
        required: true
      responses:
        '201':
          description: The newly created lead status.
          content:
            text/plain:
              schema:
                allOf:
                  - $ref: '#/components/schemas/LeadStatusResponse'
                description: >-
                  Represents a configurable status that can be assigned to
                  leads.
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/LeadStatusResponse'
                description: >-
                  Represents a configurable status that can be assigned to
                  leads.
            text/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/LeadStatusResponse'
                description: >-
                  Represents a configurable status that can be assigned to
                  leads.
components:
  schemas:
    LeadStatusRequest:
      type: object
      properties:
        name:
          type:
            - 'null'
            - string
          description: Display name for the lead status.
        color:
          type:
            - 'null'
            - string
          description: Display color for the lead status.
        category:
          enum:
            - Open
            - Qualified
            - Converted
            - Lost
            - Invalid
            - Duplicate
          type:
            - 'null'
            - string
          description: >-
            Controlled lead status change categories used for reporting,
            automation, and analytics.
        sortOrder:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: Relative display order for the lead status.
          format: int32
      description: Defines the editable values used to create or update a lead status.
    LeadStatusResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the lead status.
        organizationId:
          type: string
          description: Identifier of the organization that owns the lead status.
        name:
          type: string
          description: Display name of the lead status.
        color:
          type: string
          description: Display color assigned to the lead status.
        category:
          allOf:
            - $ref: '#/components/schemas/LeadStatusCategory'
          description: LeadStatusChange category represented by the lead status.
        sortOrder:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          description: Relative display order of the lead status.
          format: int32
        isArchived:
          type: boolean
          description: Indicates whether the lead status has been archived.
        modifiedAt:
          type: string
          description: Date and time when the lead status was last modified.
          format: date-time
      description: Represents a configurable status that can be assigned to leads.
    LeadStatusCategory:
      enum:
        - Open
        - Qualified
        - Converted
        - Lost
        - Invalid
        - Duplicate
      type: string
      description: >-
        Controlled lead status change categories used for reporting, automation,
        and analytics.

````