Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Bearer token via Authorization header

Headers

Idempotency-Key
string

Optional request idempotency key.

Required string length: 1 - 128

Body

application/json
billingPreference
enum<string>

Prefer a free package seat ('included', default) or force the paid checkout ('rent')

Available options:
included,
rent
country
string

Optional ISO 3166-1 alpha-2 country code from GET /numbers/countries. Cannot be combined with purpose.

Required string length: 2
Pattern: ^[a-z]{2}$
Example:

"de"

label
string | null

User-defined display label — NFC-normalized, up to 100 GRAPHEMES (not UTF-16 code units; an emoji/flag may span several). Display-only, never used for routing. Also seeds the billing entity name at purchase.

Example:

"Support line"

purpose
string

Optional Mobilerun Phone purpose slug from GET /numbers/purposes.

Required string length: 1 - 96
Example:

"telegram"

Response

Number purchase accepted — poll GET /numbers/phones/{id}

data
object
required