Skip to main content
DELETE
Delete Contact Data
Use this endpoint when the state stored against a caller’s phone number is no longer needed. Deletion removes the current value from reads while keeping the contact itself and its revision history. Deletion is idempotent. If no current data exists, the endpoint still returns success with "deleted": false. Data is scoped to your organization. US numbers can be formatted or sent as digits. Non-US numbers must include the + country code. URL-encode the + when it appears in the path.
The response confirms the normalized phone number and whether a current value was deleted:
The endpoint returns 401 when authentication fails and 422 when the phone number is invalid.

Authorizations

Authorization
string
header
required

Path Parameters

phoneNumber
string
required

The caller's phone number. US numbers may be formatted or sent as digits; non-US numbers must include the + country code.

Response

Contact data deletion result.

phoneNumber
string
required

The normalized phone number in E.164 format.

deleted
boolean
required

Whether a current value was deleted.