Skip to main content
DELETE
Released numbers cannot be reclaimed for 30 days. This action cannot be undone. After release, you also cannot purchase a new phone number for 30 days.

Path Parameters

string
required
The phone number ID to release. Format: pn_...

Response

object
What happens on release:
  • The number is immediately removed from the Twilio Messaging Service and released from your Twilio subaccount.
  • The phone number record in Commune is marked released — message history is retained.
  • No credit refund is issued for unused days in the billing cycle.
  • A 30-day cooldown is applied — you cannot purchase a new phone number until 30 days after the release date.
Last modified on March 19, 2026