Skip to main content
POST
/
numbers
/
reserve
Reserve a number
curl --request POST \
  --url https://api.pokulabs.com/numbers/reserve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phoneNumber": "<string>"
}
'
{
  "id": "cab29b2d-a8be-43a6-82e1-7eb33b9fc844",
  "phoneNumber": "+14157046427",
  "createdAt": "2026-03-02T17:21:32.602Z",
  "updatedAt": "2026-03-02T17:21:32.602Z"
}

Authorizations

​
Authorization
string
header
required

Authentication header containing your Poku API key. Find it in the Poku dashboard. The format is "Bearer YOUR_API_KEY"

Body

application/json
​
phoneNumber
string
required

The phone number to reserve, in E.164 format. Must be a number returned by List available numbers.

Response

Number successfully reserved.

​
id
string<uuid>
required

Unique identifier for the reserved number.

​
phoneNumber
string
required

The reserved phone number in E.164 format.

​
createdAt
string<date-time>
required

When the number was reserved.

​
updatedAt
string<date-time>
required

When the record was last updated.