Contact Phone Numbers

Delete a contact phone number

Remove a phone number from a contact. Idempotency-Key is optional. Returns `{ data: { affected } }`.

DELETE /v2/contact-phone-numbers/{contactId}/{phoneNumberId}

Parameters

Path parameters

contactId
string (uuid) required
phoneNumberId
string (uuid) required

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.affected
integer required
data.ids
array<string>
data.failed
array<object>
data.failed[].id
string
data.failed[].error
object
data.failed[].error.code
string
data.failed[].error.message
string

Example

{
  "data": {
    "affected": 0
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

409

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v2/contact-phone-numbers/00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000 \
  --request DELETE \
  --header 'Authorization: Bearer YOUR_API_KEY'
Copyright © 2026