ghl_phone_purchase_number
Purchases a phone number for a specific location using payment and Twilio details, enabling number provisioning through the GoHighLevel phone system.
Instructions
Purchase number for location
Purchase number for location. With version: v3, the HTTP 201 body is the standard success envelope (status, data, message, statusCode). The v3 purchase fields live under data: number, locationId, id, and underLcAccount (renamed from under_ghl_account).
Endpoint: POST /phone-system/numbers/location/{locationId}/purchase (Version header: v3; source: v3/phone-system-v3.json)
Requires a Sub-Account (location) token.
OAuth scopes: phonenumbers.write
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": {
"locationId": "<locationId>",
"body": "<body>"
},
"name": "ghl_phone_purchase_number"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Request body (schema carried verbatim from the official OpenAPI spec). | |
| locationId | Yes | Location ID as string |