Purchase number
purchase_numberBuy a phone number for your account (free sandbox numbers with test keys). Live numbers are billed monthly.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phone_number": "<phone_number>"
},
"name": "purchase_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_id | No | Optional: assign the number to one of your customers | |
| phone_number | Yes | The number to buy, in E.164 | |
| idempotency_key | No | Optional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose. | |
| registration_id | No | Optional (live numbers): the registration this number should send for. Without it the number follows your account's registration. |