Delete Phone Number
Release and remove a phone number from your organization.
Endpoint
https://www.tabbly.io/api/phone-numbers/delete
Delete Phone Number
Release a phone number from your organization. This cannot be undone.
Endpoint
http
POST https://www.tabbly.io/api/phone-numbers/deleteAuthentication
See Introduction. This is a POST endpoint — include api_key in the JSON request body.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
api_key |
string | Yes | Your organization API key |
phone_number |
string | Yes | Number to delete (E.164) |
number |
string | No | Alias for phone_number (same meaning; phone_number is used if both are sent) |
Example request
bash
curl -X POST "https://www.tabbly.io/api/phone-numbers/delete" \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"phone_number": "+918031321970"
}'Response
Success (200)
json
{
"success": true,
"message": "Number unrented successfully.",
"phone_number": "+918031321970",
"organization_id": 3282,
"tabbly_status": "success"
}Error responses
json
{
"success": false,
"error": "Human-readable error description"
}| HTTP status | When |
|---|---|
| 400 | Missing API key or phone number |
| 401 | Invalid API key |
| 404 | Phone number not found for this organization |
| 405 | Method not POST |