Contacts

Manage your CRM contacts (leads). Search, create, update, and organize contacts across lists and pipeline stages.

Mass action types for PUT /leads/api/leads/mass-action: contact_add_tags, contact_remove_tags, contact_replace_tags, contact_change_list, contact_change_pipeline_stage, contact_change_custom_field, contact_add_to_flow, contact_cancel_from_flows, contact_delete, contact_export_csv, contact_mark_read.

Operations

Find a contact

Request

Look up a single contact by LinkedIn ID, email address, or name + company combination. At least one identifier must be provided. This is useful for checking if a contact already exists before creating a new one.

Security

bearerAuth

Bodyapplication/jsonrequired

Any of:

linkedin_idstring or null

LinkedIn profile URL or member ID.

Example:"john-doe-123456"

emailstring or null

Email address to search by.

Example:"john@example.com"

namestring or null

Full name of the contact.

Example:"John Doe"

company_namestring or null

Company name (required when searching by name).

Example:"Acme Inc"

disable_aggregationboolean

Skip enrichment data aggregation in the response.

POST

/leads/api/leads/lookup-one

curl -i -X POST \
  https://leadgen.grinfi.io/leads/api/leads/lookup-one \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "linkedin_id": "john-doe-123456"
  }'

Responses

Contact found.

Bodyapplication/json

uuidstring

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

team_idinteger

user_idinteger or null

sender_profile_uuidstring or null

list_uuidstring

data_source_uuidstring or null

pipeline_stage_uuidstring

company_uuidstring or null

namestring or null

Example:"John Doe"

first_namestring or null

Example:"John"

last_namestring or null

Example:"Doe"

company_namestring or null

Example:"Acme Inc"

company_ln_idstring or null

positionstring or null

Example:"VP of Sales"

headlinestring or null

Example:"VP of Sales at Acme Inc"

aboutstring or null

avatar_urlstring or null

ln_idstring or null

LinkedIn member ID.

sn_idstring or null

Sales Navigator ID.

linkedinstring or null

Example:"john-doe-123456"

facebookstring or null

twitterstring or null

work_emailstring or null

Example:"john@acme.com"

personal_emailstring or null

work_phone_numberstring or null

personal_phone_numberstring or null

connections_numberinteger or null

followers_numberinteger or null

primary_languagestring or null

supported_languagesArray of strings or null

has_open_profileinteger or null

has_verified_profileinteger or null

has_premiuminteger or null

experienceArray of objects or null

postsArray of objects or null

educationsArray of objects or null

skillsArray of strings or null

raw_addressstring or null

Example:"San Francisco, CA, USA"

locationArray of objects or null

tagsArray of strings or null

Tag UUIDs.

statusstring

Example:"ok"

linkedin_statusstring

Example:"active"

email_statusstring or null

unread_countsArray of objects

last_automation_approve_atstring or null, (date-time)

created_atstring or null, (date-time)

updated_atstring or null, (date-time)

Response

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "team_id": 0,
  "user_id": 0,
  "sender_profile_uuid": "string",
  "list_uuid": "string",
  "data_source_uuid": "string",
  "pipeline_stage_uuid": "string",
  "company_uuid": "string",
  "name": "John Doe",
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Acme Inc",
  "company_ln_id": "string",
  "position": "VP of Sales",
  "headline": "VP of Sales at Acme Inc",
  "about": "string",
  "avatar_url": "string",
  "ln_id": "string",
  "sn_id": "string",
  "linkedin": "john-doe-123456",
  "facebook": "string",
  "twitter": "string",
  "work_email": "john@acme.com",
  "personal_email": "string",
  "work_phone_number": "string",
  "personal_phone_number": "string",
  "connections_number": 0,
  "followers_number": 0,
  "primary_language": "string",
  "supported_languages": [
    "string"
  ],
  "has_open_profile": 0,
  "has_verified_profile": 0,
  "has_premium": 0,
  "experience": [
    { … }
  ],
  "posts": [
    { … }
  ],
  "educations": [
    { … }
  ],
  "skills": [
    "string"
  ],
  "raw_address": "San Francisco, CA, USA",
  "location": [
    { … }
  ],
  "tags": [
    "string"
  ],
  "status": "ok",
  "linkedin_status": "active",
  "email_status": "string",
  "unread_counts": [
    { … }
  ],
  "last_automation_approve_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}