Skip to main content
POST
/
v1
/
contacts
/
by-emails
Find contacts by email
curl --request POST \
  --url https://api.prod.getdex.com/v1/contacts/by-emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "jsmith@example.com"
  ],
  "createFromGoogleContacts": true,
  "createFromOAuthInteractions": true
}
'
{
  "error": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "full_name": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "job_title": "<string>",
      "company": "<string>",
      "description": "<string>",
      "legacy_location": "<string>",
      "website": "<string>",
      "image_url": "<string>",
      "starred": true,
      "is_archived": true,
      "birthday": "<string>",
      "linkedin": "<string>",
      "twitter": "<string>",
      "facebook": "<string>",
      "instagram": "<string>",
      "frequency": "<string>",
      "source": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ]
}

Use cases

  • Resolve email senders to existing Dex contacts
  • Check if contacts already exist before importing
  • Enrich email threads with contact information from Dex
Pass an array of email addresses in the request body. The response maps each email to its matching contact, if one exists.

Authorizations

Authorization
string
header
required

Use your Dex API key (e.g. dex_abc123...) as the Bearer token.

Query Parameters

include
object

Body

application/json
emails
string<email>[]
required
createFromGoogleContacts
boolean
createFromOAuthInteractions
boolean

Response

Successful response

error
boolean
required
data
object[]
required