Phone Numbers

Every outbound message is sent from a phone number provisioned on your account. This guide covers how to discover those numbers programmatically and watch for status changes.

List your phone numbers

List every number assigned to the authenticated partner. See the List Phone Numbers API reference for the full endpoint specification.

curl https://api.linqapp.com/api/partner/v3/phone_numbers \
  -H "Authorization: Bearer $LINQ_API_KEY"

const { phone_numbers } = await client.phoneNumbers.list();

for (const pn of phone_numbers) {
  console.log(pn.phone_number); // e.g. "+12223334444"
}

result = client.phone_numbers.list()
for pn in result.phone_numbers:
    print(pn.phone_number)

Use the returned phone_number values as the from field when creating a chat, listing chats, or sending a voice memo.

Provisioning

Numbers are provisioned by your Linq representative — there is no self-serve create or delete endpoint on the V3 API. To add or release a line, contact support with the details of the line you want changed.

Status changes

Numbers have a runtime status:

• ACTIVE — healthy and sending/receiving normally
• FLAGGED — a service flag has degraded the number’s ability to send. New messages on a flagged line may fail with delivery errors.

Status transitions are delivered via the phone_number.status_updated webhook. Subscribe to this event if your application relies on specific lines staying healthy.

{
  "phone_number": "+12025551234",
  "previous_status": "ACTIVE",
  "new_status": "FLAGGED",
  "changed_at": "2026-02-18T18:35:05.000Z"
}

You can also enable Flagged-number Slack notifications in the API Tooling settings to get a Slack message in your linked partner channel whenever a number’s status changes.

Recommended handling:

• Page on-call when a production line transitions to FLAGGED
• Pause outbound sends on the affected line until it returns to ACTIVE
• Contact your Linq representative for remediation

Related

• Key Concepts: Phone Numbers
• Webhooks: Phone number events
• API Reference: Phone Numbers