INinstantly
CRMActions

Delete phone number

Changed on

Remove a phone number from the organization. Provider cleanup is retried automatically if delayed. Deleting an unknown or already removed number returns 404. A number that cannot be released because the workspace has no phone account returns 409 and is kept.

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

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

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/crm-actions/phone-numbers/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:01a19e6f-8c76-78aa-aa80-8edcd11ae7ad

The phone number record id to delete

Response

Default Response

cleanup_pendingboolean

Whether deletion cleanup is still pending after removal from the workspace.

idstring

Unique identifier of the deleted phone number record.

timestamp_createdstring date-time

Timestamp when the deleted record was originally created.

organization_idstring

Identifier of the organization that owned the phone number.

phone_numberstring

The deleted phone number.

countrystring

Country code of the deleted phone number.

localitystring

Region or city associated with the deleted phone number.

subscription_idstring

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

twilio_sidstring

Twilio SID of the deleted number.

Example response

{
  "cleanup_pending": true,
  "id": "01a19e6f-8c76-78aa-aa80-8edd77cddd37",
  "timestamp_created": "2026-11-02T22:44:33.014Z",
  "organization_id": "01a19e6f-8c76-78aa-aa80-8ede6a0309cc",
  "phone_number": "+15551234567",
  "country": "US",
  "locality": "San Francisco",
  "subscription_id": "sub_1PuaE1B3VEKBA0ygDAKk7QVc",
  "twilio_sid": "PN998dda028e07a49c8038b2206341d463"
}

Changes

  • c781051105a8Revision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status