blink-new Blink Phone
Manage workspace phone numbers for AI calling via blink phone.
Numbers are US phone numbers provisioned through Vapi. You can still CALL international
numbers — the FROM number is US but the destination can be any country.
List all workspace phone numbers
blink phone list
blink phone list --json
Output shows: number, label, status (● active / ⚡ grace), ★ primary badge, next charge date.
Buy a new phone number
# Any available US number
blink phone buy --label "Sales"
# Specific area code (Vapi picks the best available in that area)
blink phone buy --label "Primary" --area-code 914
blink phone buy --label "Support" --area-code 826
blink phone buy --label "Outreach" --area-code 775
# Get JSON (useful for scripting)
NUMBER=$(blink phone buy --label "Bot" --area-code 914 --json | python3 -c "import json,sys; print(json.loads(sys.stdin.read())['phone_number'])")
Costs 25 credits immediately (first month), then 25 credits/month recurring.
Update a number's label
blink phone label wpn_abc12345 "Sales"
blink phone label wpn_abc12345 "Support line"
blink phone label wpn_abc12345 "" # Clear label
Get the ID from blink phone list --json | python3 -c "import json,sys; print(json.loads(sys.stdin.read())[0]['id'])".
Release (cancel) a number
blink phone release wpn_abc12345 --yes # Skip confirmation
blink phone release wpn_abc12345 # Interactive confirmation
The number is permanently returned to the pool. Cannot be undone.
Full self-provisioning flow (agent buys its own number and calls)
# 1. Check if a number exists
NUMBERS=$(blink phone list --json)
COUNT=$(echo "$NUMBERS" | python3 -c "import json,sys; print(len(json.loads(sys.stdin.read())))")
# 2. Buy one if none exists
if [ "$COUNT" -eq 0 ]; then
blink phone buy --label "Primary" --area-code 914
fi
# 3. Get the primary number
FROM=$(blink phone list --json | python3 -c "import json,sys; print(json.loads(sys.stdin.read())[0]['phone_number'])")
# 4. Make a call from that number (destination can be any country)
blink ai call "+14155551234" "Your task here." --from "$FROM"
Command signatures
blink phone # Alias for list
blink phone list [--json]
blink phone buy [--label <name>] [--area-code <3digits>] [--json]
blink phone label <id> <label>
blink phone release <id> [--yes] [--json]
Available area codes (US)
Vapi suggests: 914 (NY), 826 (CA area), 775 (NV) — others may be available.
If an area code is unavailable, Vapi returns: "This area code is not available. Hint: Try one of 914, 826, 775."
Billing
- 25 credits charged immediately on buy (first month)
- 25 credits charged monthly on anniversary date
- Numbers in grace period (payment failed) pause calls for 7 days then are released
- 1 credit = $0.25 · 25 credits/month = $6.25/month per number