Delete Phone Number

Releases a phone number from your organization.

• Inventory numbers (India stock): removed from your account and returned to available inventory so another organization can buy them. SIP setup on the number is kept for reuse. Wallet is not refunded.
• Other numbers: released from the carrier account when applicable, then removed from your organization.

Deleting is permanent for your organization (you lose ownership immediately). Inventory numbers may become buyable again for others.

Endpoint

POST https://www.tabbly.io/api/phone-numbers/delete

Authentication

See Introduction. This is a POST endpoint — include api_key in the JSON request body.

Request body

Example request

curl -X POST "https://www.tabbly.io/api/phone-numbers/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "phone_number": "+918065830105"
  }'

Response

Success (200)

{
  "success": true,
  "message": "Phone number released successfully.",
  "phone_number": "+918065830105",
  "organization_id": 3282,
  "tabbly_status": "success"
}

Error responses

{
  "success": false,
  "error": "Human-readable error description"
}