Skip to main content
During the beta, reserving a phone number is free. Each account is limited to one number at a time. If you’d like a different number, delete your current one and purchase a new one.

​
How to reserve a number

There are two ways to reserve a number: via the Poku dashboard, or programmatically (either directly via the API or by asking your Poku agent).

​
Option 1 — Dashboard

1

Log in to the Poku dashboard

Go to dashboard.pokulabs.com.
2

Open the Phones tab

Navigate to the Phones tab in the sidebar.
3

Purchase a number

Browse available numbers, find one you like, and hit Purchase.
Once the number appears in your purchased numbers list, your agent will automatically use it for all outbound calls and texts.

​
Option 2 — Programmatically (API or agent)

You can reserve a number directly via the API, or by asking your agent to do it for you if it has the Poku Skill installed.

​
Step 1: Browse available numbers

Fetch up to 10 available numbers, optionally filtering by country (US or GB) and area code: 
curl -s -G \
  -H "Authorization: Bearer <your-poku-api-key>" \
  --data-urlencode "country=<US|GB>" \
  --data-urlencode "areaCode=<area code>" \
  --data-urlencode "limit=10" \
  https://api.pokulabs.com/reserved-numbers/available
Omit any parameters you don’t need. If you just want any available number, pass limit=1 and skip the filters. An empty response means no numbers match — try broadening your search.

​
Step 2: Reserve your chosen number

Once you’ve identified the number you want, reserve it with a POST request: 
curl -s -X POST \
  -H "Authorization: Bearer <your-poku-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "<selected number>"}' \
  https://api.pokulabs.com/reserved-numbers/reserve
On success, the number is immediately reserved to your account and ready for use.

​
Asking your agent

If you have the Poku Skill installed, you can also ask your agent in plain language, for example:
“Reserve a phone number for me with a 916 area code.”
The agent will browse available numbers, confirm your selection, and complete the reservation on your behalf.

​
Verify your reserved number

You can confirm your reserved number is registered to your Poku account at any time with a GET request: 
curl -H 'Authorization: Bearer <your-poku-api-key>' \
  https://api.pokulabs.com/reserved-numbers
A successful response returns your reserved number: 
[
  {
    "id": "cab29b2d-...",
    "phone_number": "+14157046427",
    "created_at": "2026-03-02T17:21:32.602Z"
  }
]
An empty array ([]) means no number is currently reserved on your account.