Delete phone number

Delete a specific phone number from the organization.

Requires one of the following scopes: crm_actions:delete, crm_actions:all, all:delete, all:all

DELETE /api/v2/crm-actions/phone-numbers/{id}

Delete phone number

cURL

curl --request DELETE \
  --url https://api.instantly.ai/api/v2/crm-actions/phone-numbers/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "019e3bd1-b564-7899-a418-01b789e61e38",
  "timestamp_created": "2026-05-18T16:00:59.748Z",
  "organization_id": "019e3bd1-b564-7899-a418-01b88b2a56ec",
  "phone_number": "[phone]",
  "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:

"019e3bd1-b564-7899-a418-01b6230afa2a"

Response

200

application/json

Default Response

id · string

Unique identifier of the deleted phone number record.

Example:

"019e3bd1-b564-7899-a418-01b789e61e38"

timestamp_created · string<date-time>

Timestamp when the deleted record was originally created.

Example:

"2026-05-18T16:00:59.748Z"

organization_id · string

Identifier of the organization that owned the phone number.

Example:

"019e3bd1-b564-7899-a418-01b88b2a56ec"

phone_number · string

The deleted phone number.

Example:

"[phone]"

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"