Skip to content

Release phone number

Release a purchased phone number. This will:

  1. Disconnect any linked WhatsApp social account
  2. Decrement the Stripe subscription quantity (or cancel if last number)
  3. Release the number from Telnyx
  4. Mark the number as released

DELETE /v1/whatsapp/phone-numbers/{phoneNumberId}

Release a purchased phone number. This will:

  1. Disconnect any linked WhatsApp social account
  2. Decrement the Stripe subscription quantity (or cancel if last number)
  3. Release the number from Telnyx
  4. Mark the number as released

Parameters

  • phoneNumberId (path, string) required — Phone number record ID

Responses

200 — Phone number released successfully

  • message (string)
  • phoneNumber (object)

400 — Phone number is already released or being released

401

404