Sign in
Customer

Schedule customer deletion (freeze account).

Marks the customer for deletion. The account enters 'frozen' state immediately. Active calls are terminated and new operations are blocked. The customer has 30 days to recover before permanent deletion. Admin-only endpoint.

post/customers/{id}/freeze

Path parameters

idstring required

Response

idstring uuid

The unique identifier of the customer.

namestring

Name of the customer.

detailstring

Details about the customer.

emailstring email

Email address of the customer.

phone_numberstring

Customer's contact phone number in E.164 format.

addressstring

Address of the customer.

webhook_method'' | 'POST' | 'GET' | 'PUT' | 'DELETE'

The HTTP method used for webhook (e.g., POST, GET, PUT, DELETE).

webhook_uristring

URI where webhook events are delivered.

billing_account_idstring uuid

The unique identifier of the customer's default billing account. Returned from the GET /billing_accounts/{id} response.

email_verifiedboolean

Whether the customer's email has been verified.

status'initial' | 'active' | 'frozen' | 'deleted' | 'expired'

Account lifecycle status.

identity_verification_status'none' | 'pending' | 'verified' | 'rejected'

Customer's identity verification status. Determines access to PSTN number purchases and outbound PSTN calls.

tm_deletion_scheduledstring date-time

Timestamp when account deletion was requested. Null if not scheduled.

tm_createstring date-time

Timestamp when the customer was created.

tm_updatestring date-time

Timestamp when the customer was last updated.

tm_deletestring date-time

Timestamp when the customer was deleted.

terms_agreed_versionstring

Version identifier of the Terms of Service the customer agreed to. Format: YYYY-MM-DD date string matching a published ToS revision.

terms_agreed_ipstring ipv4

IPv4 address from which the customer accepted the Terms of Service. Logged for legal compliance and audit trail.

Example response

{
  "id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "name": "Acme Corporation",
  "detail": "Enterprise customer account",
  "email": "admin@acme.com",
  "phone_number": "+14155551234",
  "address": "123 Main St, San Francisco, CA 94105",
  "webhook_method": "POST",
  "webhook_uri": "https://api.acme.com/webhooks/voipbin",
  "billing_account_id": "b8c9d0e1-f2a3-4567-8901-23456789abcd",
  "metadata": {
    "rtp_debug": true
  },
  "email_verified": true,
  "status": "active",
  "identity_verification_status": "none",
  "tm_deletion_scheduled": "2026-01-15T09:30:00.000000Z",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z",
  "terms_agreed_version": "2026-01-01",
  "terms_agreed_ip": "203.0.113.42"
}

Changes

Changed in 1 of the 54 revisions of this API.2

  • 79e779080bcc2See the full diff
    • ●

      added the new expired enum value to the allOf[CustomerManagerCustomer]/status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new initial enum value to the allOf[CustomerManagerCustomer]/status response property for the response status 200

      response-property-enum-value-added