Contact Emails
Update a contact email
Partially update one email on a contact (value and/or label). **Requires `Idempotency-Key`.** Returns the bulk envelope `{ data: { affected } }`.
PATCH /v2/contact-emails/{contactId}/{emailId}
Parameters
Path parameters
contactId
string (uuid) required
emailId
string (uuid) required
Request body
Content-Type: application/json
email
string (email)
label
string
ranking
integer
Example
{
"email": "[email protected]",
"label": "string"
}
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 — Request body failed validation.
Content-Type: application/json
(body)
any
401 — Missing or invalid API key.
Content-Type: application/json
(body)
any
403 — Valid key, insufficient permission.
Content-Type: application/json
(body)
any
404 — Resource does not exist.
Content-Type: application/json
(body)
any
409 — Request conflicts with the current state of the resource.
Content-Type: application/json
(body)
any
429 — Rate limit exceeded.
Content-Type: application/json
(body)
any
500 — Unexpected server error.
Content-Type: application/json
(body)
any
Code samples
curl https://api.prod.getdex.com/v2/contact-emails/00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000 \
--request PATCH \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"label": "string"
}'
fetch('https://api.prod.getdex.com/v2/contact-emails/00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000', {
method: 'PATCH',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: '[email protected]',
label: 'string'
})
})
requests.patch(
"https://api.prod.getdex.com/v2/contact-emails/00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"email": "[email protected]",
"label": "string"
}
)
Reorder contact emails
Set the display order of a contact's emails. Body is id-based: `{ order: [{ id, ranking }] }` (row ids survive, unlike v1's positional payload). **Requires `Idempotency-Key`.** Returns the bulk envelo
Delete a contact email
Remove an email from a contact. Idempotency-Key is optional (delete is idempotent; a key replays the same `affected` on retry). Returns `{ data: { affected } }`.