Skip to main content
GET
Get Contact
The path takes a lemlist contact id (ctc_xxx) or an email address. To find a contact from its CRM record id, use GET /contacts?crmIds=.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

idOrEmail
string
required

The unique identifier or email of the contact

Response

Success

A contact record in your CRM, as the lookups (GET /contacts?idsOrEmails=, GET /contacts?crmIds=, GET /contacts/{idOrEmail}) return it. Not to be confused with a lead which is a contact specifically added to a campaign.

_id
string

Unique contact identifier

teamId
string

Team identifier the contact belongs to

fullName
string

Contact's calculated full name

email
string<email>

Contact's primary email address

fields
object

Contact fields, standard (firstName, lastName, phone, jobTitle...) and custom

campaigns
object[]

List of campaigns the contact is associated with

linkedinUrl
string

Contact's LinkedIn profile URL

linkedinUrlSalesNav
string

Contact's LinkedIn Sales Navigator URL

ownerId
string

ID of the user who owns this contact

createdAt
string<date-time>

Contact creation timestamp

createdBy
string

ID of the user who created the contact

unsubscribed
boolean

Whether the contact is globally unsubscribed. When true, no outreach will be sent to this contact.

phonesStatuses
object[]

Verification status of each verified phone number.

crmSync
object

CRM sync status for the contact, resolved against the team's active CRM provider (Hubspot, Salesforce, or Pipedrive). Only present when a CRM is connected and the contact has a record in it. crmRecordId maps a crmIds lookup back to the ids sent.

fieldRejections
object[]

Values lemlist refused to write on this contact, each with its reason. Empty when none. Filter the list endpoint to only flagged contacts via GET /contacts?fieldRejectionReason=....