PhoneNumbers

Set sender number override

Sets the outgoing phone number override for a conversation so future lead messages use the selected eligible number.

post/phone-numbers/outgoing/conversation/{conversationId}/override

Request

  • Base URL: https://api.leadping.ai
  • URL: https://api.leadping.ai/phone-numbers/outgoing/conversation/{conversationId}/override
  • Auth: HTTP bearer

Path parameters

conversationIdstring required

The conversation identifier.

Request body

fromPhoneNumberIdstring required

Sender phone number ID used for this outbound SMS or call.

Response

Returns the outgoing number selection response.

canSendboolean

Indicates whether Leadping can send outbound messages using this outgoing number selection response.

setupMessagestring nullable

Human-readable setup guidance shown for this outgoing number selection response.

phoneNumberIdstring nullable

Leadping phone number ID connected to this outgoing number selection response.

numberstring nullable

E.164 phone number exposed by this outgoing number selection response.

displayNumberstring nullable

Human-readable phone number shown in Leadping UI and API responses.

healthStatus'Not Evaluated' | 'Evaluating' | 'Healthy' | 'Needs Attention' | 'Blocked' nullable

Summarizes the severity of conditions affecting an organization's ability to send compliant SMS or MMS traffic.

healthLabelstring nullable

Short label describing the health state for display in dashboards.

healthWarningstring nullable

Warning text that explains a potential health or readiness issue.

selectionReason'StickyConversation' | 'LeadAssigned' | 'CampaignOrSource' | 'Preferred' | 'LocalArea' | 'HealthyPool' | 'FallbackDefault' | 'ManualOverride' nullable

Explains why Leadping selected, rejected, or substituted an outgoing caller or messaging number.

reasonLabelstring nullable

Human-readable label for the reason code on this outgoing number selection response.

wasManuallyOverriddenboolean

Indicates whether a user manually overrode Leadping's automatic number selection for this outgoing number selection response.

campaignIdstring nullable

Messaging campaign identifier associated with this outgoing number selection response.

sourceIdstring nullable

Lead source ID considered when Leadping selected the outgoing phone number.

Changes

No recorded changes to this operation across all 1 revision of this API.