Skip to main content
POST
/
contacts
/
sync
{
  "contacts": [
    {
      "externalId": "lead-123",
      "email": "sarah.chen@techstartup.io",
      "firstName": "Sarah",
      "lastName": "Chen",
      "linkedinUrl": "https://linkedin.com/in/sarahchen"
    },
    {
      "externalId": "lead-456",
      "email": "new.prospect@unknown.com"
    }
  ]
}

{
  "results": [
    {
      "externalId": "lead-123",
      "crmId": "contact_8f3k2j",
      "properties": {
        "leadScore": 85,
        "lifecycleStage": "MQL",
        "lastActivityDate": "2024-01-15T14:30:00Z"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your Implementation Required

This endpoint must be implemented on your server
Enginy calls this endpoint to find which contacts already exist in your CRM. Your CRM decides the matching logic (by email, LinkedIn URL, phone, etc.).

​
Request

​
contacts
array
required
Array of contact objects to find

​
Contact Object

​
externalId
string
required
Enginy’s internal lead ID
​
email
string
Email address for matching
​
linkedinUrl
string
LinkedIn URL for matching
{
  "contacts": [
    {
      "externalId": "lead-123",
      "email": "sarah.chen@techstartup.io",
      "firstName": "Sarah",
      "lastName": "Chen",
      "linkedinUrl": "https://linkedin.com/in/sarahchen"
    },
    {
      "externalId": "lead-456",
      "email": "new.prospect@unknown.com"
    }
  ]
}

​
Response

Return only contacts that exist in your CRM.
​
results
array
required
Array of matched contacts
​
results[].externalId
string
required
The externalId from the request
​
results[].crmId
string
required
Your CRM’s ID for this contact
​
results[].properties
object
Optional properties to sync back to Enginy (leadScore, lifecycleStage, etc.)
{
  "results": [
    {
      "externalId": "lead-123",
      "crmId": "contact_8f3k2j",
      "properties": {
        "leadScore": 85,
        "lifecycleStage": "MQL",
        "lastActivityDate": "2024-01-15T14:30:00Z"
      }
    }
  ]
}
Contact lead-456 is not in the response because it doesn’t exist in the CRM. Only return matches.