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": "019dc79a-c3f6-7337-86ad-428166ae2326",
  "timestamp_created": "2026-04-26T02:25:01.942Z",
  "organization_id": "019dc79a-c3f6-7337-86ad-428207807fd0",
  "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:

"019dc79a-c3f5-7231-9b03-6ac01f75930d"

Response

Default Response

​
id
string

Unique identifier of the deleted phone number record.

Example:

"019dc79a-c3f6-7337-86ad-428166ae2326"

​
timestamp_created
string<date-time>

Timestamp when the deleted record was originally created.

Example:

"2026-04-26T02:25:01.942Z"

​
organization_id
string

Identifier of the organization that owned the phone number.

Example:

"019dc79a-c3f6-7337-86ad-428207807fd0"

​
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"