Contact Emails

Create a contact email

Add an email address to a contact, optionally with a label (e.g. "Work"). **Requires `Idempotency-Key`.** Returns the created row: `{ data: { contact_email: {...} } }`, status 201.

POST /v2/contact-emails/{contactId}

Parameters

Path parameters

contactId
string (uuid) required

Header parameters

Idempotency-Key
string required
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

Content-Type: application/json

email
string (email) required
label
string
ranking
integer

Example

{
  "email": "[email protected]"
}

Responses

201 — Created

Content-Type: application/json

data
object required
data.email
object required
data.email.id
string (uuid) required
data.email.contact_id
string (uuid) required
data.email.user_id
string
data.email.workspace_id
string (uuid) | null
data.email.email
string required
data.email.label
string | null
data.email.ranking
integer required
data.email.created_at
string (date-time) required
data.email.updated_at
string (date-time) required

Example

{
  "data": {
    "email": {
      "id": "00000000-0000-0000-0000-000000000000",
      "contact_id": "00000000-0000-0000-0000-000000000000",
      "email": "string",
      "ranking": 0,
      "created_at": "2026-11-16T08:36:49.917Z",
      "updated_at": "2026-11-16T08:36:49.917Z"
    }
  }
}

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 \
  --request POST \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header "Idempotency-Key: $(uuidgen 2>/dev/null || python3 -c 'import uuid;print(uuid.uuid4())')" \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "[email protected]"
}'
Copyright © 2026