> ## 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.

# Select new lead sender number

> Selects an outgoing phone number for a new outbound lead message using destination, source, and delivery eligibility rules.



## OpenAPI

````yaml /openapi.json post /phone-numbers/outgoing/new
openapi: 3.0.4
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:
  /phone-numbers/outgoing/new:
    post:
      tags:
        - PhoneNumbers
      summary: Select new lead sender number
      description: >-
        Selects an outgoing phone number for a new outbound lead message using
        destination, source, and delivery eligibility rules.
      operationId: PhoneNumbers_GetOutgoingForNewOutbound
      requestBody:
        description: The outgoing number selection request payload for the operation.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/OutgoingNumberSelectionRequest'
              description: >-
                Request schema for the Leadping API outgoing number selection
                request, including the fields clients can send.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/OutgoingNumberSelectionRequest'
              description: >-
                Request schema for the Leadping API outgoing number selection
                request, including the fields clients can send.
        required: true
      responses:
        '200':
          description: Returns the outgoing number selection response.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/OutgoingNumberSelectionResponse'
                description: >-
                  Response schema for the Leadping API outgoing number selection
                  response returned to authenticated clients.
        '400':
          description: The request was invalid or failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    OutgoingNumberSelectionRequest:
      type: object
      properties:
        conversationId:
          type: string
          description: >-
            Conversation ID that links this outgoing number selection request to
            the Leadping inbox thread.
          nullable: true
        leadId:
          type: string
          description: Lead ID used to choose the best outgoing sender number.
          nullable: true
        recipientPhoneNumber:
          type: string
          description: Recipient phone number that receives the outbound message or call.
          nullable: true
        channel:
          enum:
            - sms
            - call
          type: string
          description: Defines the supported Outgoing Number Channel values.
          nullable: true
        campaignId:
          type: string
          description: >-
            Messaging campaign identifier associated with this outgoing number
            selection request.
          nullable: true
        sourceId:
          type: string
          description: Lead source ID used to choose the best outgoing sender number.
          nullable: true
        teamId:
          type: string
          description: Organization ID used to choose the best outgoing sender number.
          nullable: true
      description: >-
        Request schema for the Leadping API outgoing number selection request,
        including the fields clients can send.
    OutgoingNumberSelectionResponse:
      type: object
      properties:
        canSend:
          type: boolean
          description: >-
            Indicates whether Leadping can send outbound messages using this
            outgoing number selection response.
        setupMessage:
          type: string
          description: >-
            Human-readable setup guidance shown for this outgoing number
            selection response.
          nullable: true
        phoneNumberId:
          type: string
          description: >-
            Leadping phone number ID connected to this outgoing number selection
            response.
          nullable: true
        number:
          type: string
          description: >-
            E.164 phone number exposed by this outgoing number selection
            response.
          nullable: true
        displayNumber:
          type: string
          description: Human-readable phone number shown in Leadping UI and API responses.
          nullable: true
        healthStatus:
          enum:
            - Not Evaluated
            - Evaluating
            - Healthy
            - Needs Attention
            - Blocked
          type: string
          description: Defines the supported SMS readiness health assessments.
          nullable: true
        healthLabel:
          type: string
          description: Short label describing the health state for display in dashboards.
          nullable: true
        healthWarning:
          type: string
          description: Warning text that explains a potential health or readiness issue.
          nullable: true
        selectionReason:
          enum:
            - StickyConversation
            - LeadAssigned
            - CampaignOrSource
            - Preferred
            - LocalArea
            - HealthyPool
            - FallbackDefault
            - ManualOverride
          type: string
          description: Defines the supported Outgoing Number Selection Reason values.
          nullable: true
        reasonLabel:
          type: string
          description: >-
            Human-readable label for the reason code on this outgoing number
            selection response.
          nullable: true
        wasManuallyOverridden:
          type: boolean
          description: >-
            Indicates whether a user manually overrode Leadping's automatic
            number selection for this outgoing number selection response.
        campaignId:
          type: string
          description: >-
            Messaging campaign identifier associated with this outgoing number
            selection response.
          nullable: true
        sourceId:
          type: string
          description: >-
            Lead source ID considered when Leadping selected the outgoing phone
            number.
          nullable: true
        eligibleNumbers:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/EligibleOutgoingNumberResponse'
            description: >-
              Response schema for the Leadping API eligible outgoing phone
              number returned to authenticated clients.
          description: >-
            Phone numbers that are eligible to send the requested outbound
            message or call.
      description: >-
        Response schema for the Leadping API outgoing number selection response
        returned to authenticated clients.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    EligibleOutgoingNumberResponse:
      type: object
      properties:
        phoneNumberId:
          type: string
          description: >-
            Leadping phone number ID connected to this eligible outgoing phone
            number.
        number:
          type: string
          description: E.164 phone number exposed by this eligible outgoing phone number.
        displayNumber:
          type: string
          description: Human-readable phone number shown in Leadping UI and API responses.
        healthStatus:
          enum:
            - Not Evaluated
            - Evaluating
            - Healthy
            - Needs Attention
            - Blocked
          type: string
          description: Defines the supported SMS readiness health assessments.
          nullable: true
        healthLabel:
          type: string
          description: Short label describing the health state for display in dashboards.
          nullable: true
        healthWarning:
          type: string
          description: Warning text that explains a potential health or readiness issue.
          nullable: true
        canSend:
          type: boolean
          description: >-
            Indicates whether Leadping can send outbound messages using this
            eligible outgoing phone number.
        selectionReason:
          allOf:
            - $ref: '#/components/schemas/OutgoingNumberSelectionReason'
          description: Reason Leadping selected this outbound sender number.
        reasonLabel:
          type: string
          description: >-
            Human-readable label for the reason code on this eligible outgoing
            phone number.
        label:
          type: string
          description: >-
            Short display label for this eligible outgoing phone number,
            formatted for charts, filters, or list views.
          nullable: true
        campaignId:
          type: string
          description: >-
            Messaging campaign identifier associated with this eligible outgoing
            phone number.
          nullable: true
        sourceId:
          type: string
          description: >-
            Lead source ID used to determine this phone number's outbound
            eligibility.
          nullable: true
        teamId:
          type: string
          description: >-
            Organization ID used to determine this phone number's outbound
            eligibility.
          nullable: true
        isSelected:
          type: boolean
          description: >-
            Indicates whether this eligible outgoing phone number was selected
            for the requested operation.
      description: >-
        Response schema for the Leadping API eligible outgoing phone number
        returned to authenticated clients.
    OutgoingNumberSelectionReason:
      enum:
        - StickyConversation
        - LeadAssigned
        - CampaignOrSource
        - Preferred
        - LocalArea
        - HealthyPool
        - FallbackDefault
        - ManualOverride
      type: string
      description: Defines the supported Outgoing Number Selection Reason values.

````