Skip to main content
DELETE
/
api
/
v2
/
crm-actions
/
phone-numbers
/
{id}
Delete phone number
curl --request DELETE \
  --url https://api.instantly.ai/api/v2/crm-actions/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "019cc043-e334-7ee5-909f-00b2f9c84e25",
  "timestamp_created": "2026-03-05T23:10:00.500Z",
  "organization_id": "019cc043-e334-7ee5-909f-00b3fa16ff52",
  "phone_number": "+15551234567",
  "country": "US",
  "locality": "San Francisco",
  "subscription_id": "sub_1PuaE1B3VEKBA0ygDAKk7QVc",
  "twilio_sid": "PN998dda028e07a49c8038b2206341d463"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The phone number record id to delete

Example:

"019cc043-e334-7ee5-909f-00b1cfd9a600"

Response

Default Response

​
id
string

Unique identifier of the deleted phone number record.

Example:

"019cc043-e334-7ee5-909f-00b2f9c84e25"

​
timestamp_created
string<date-time>

Timestamp when the deleted record was originally created.

Example:

"2026-03-05T23:10:00.500Z"

​
organization_id
string

Identifier of the organization that owned the phone number.

Example:

"019cc043-e334-7ee5-909f-00b3fa16ff52"

​
phone_number
string

The deleted phone number.

Example:

"+15551234567"

​
country
string

Country code of the deleted phone number.

Example:

"US"

​
locality
string

Region or city associated with the deleted phone number.

Example:

"San Francisco"

​
subscription_id
string

Billing subscription ID associated with this number (if any).

Example:

"sub_1PuaE1B3VEKBA0ygDAKk7QVc"

​
twilio_sid
string

Twilio SID of the deleted number.

Example:

"PN998dda028e07a49c8038b2206341d463"