← ClaudeAtlas

managing-numberslisted

Manages the phone numbers a Sendly workspace owns — list them, inspect one, set the default sender, cancel a scheduled release, or release a number. Applies when viewing owned numbers, choosing which number sends by default, or giving a number back to the carrier.
SendlyHQ/sendly-skills · ★ 0 · AI & Automation · score 62
Install: claude install-skill SendlyHQ/sendly-skills
# Managing Numbers with Sendly List the numbers your workspace owns, inspect a single number, pick the default sender, and release numbers you no longer need. To *buy* a new number, see the discovery/buy flow at the end. ## Quick start ```typescript import Sendly from "@sendly/node"; const sendly = new Sendly(process.env.SENDLY_API_KEY!); const { numbers } = await sendly.numbers.list(); for (const n of numbers) { console.log(`${n.phoneNumber} — ${n.status}`); } ``` ## Authentication All requests require a Bearer token (`SENDLY_API_KEY`). Reads need the `numbers:read` scope; mutations (set default, cancel release, release) need `numbers:write`. ## REST API **Base URL:** `https://sendly.live/api/v1` ### The owned-number shape ```json { "id": "num_abc123", "phoneNumber": "+14155551234", "status": "active", "source": "purchased", "countryCode": "US", "phoneNumberType": "toll_free", "monthlyCostCents": 110, "isDefault": true, "requirementsSubmittedAt": null, "pendingCancellation": false, "scheduledReleaseAt": null } ``` - `status` — `provisioning`, `requirements_required`, `active`, or `failed`. A number can only send once it is `active`. - `requirementsSubmittedAt` — for a `requirements_required` number, `null` means "still needs documents", non-null means "documents submitted, under carrier review". - `isDefault` — only present on the single-number responses (`GET /numbers/:id`, `PATCH /numbers/:id`); the list projection omits it. - `pendingCa