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
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-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 } }`.