Skip to main content
POST
/
contacts
{
  "contacts": [
    {
      "externalId": "lead-123",
      "email": "john.doe@example.com",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+1234567890",
      "company": "Acme Inc",
      "title": "CEO",
      "linkedinUrl": "https://linkedin.com/in/johndoe"
    }
  ]
}

{
  "results": [
    {
      "externalId": "lead-123",
      "crmId": "crm-contact-456"
    }
  ]
}

Your Implementation Required

This endpoint must be implemented on your server
Enginy calls this endpoint to create contacts in your CRM when exporting leads.

​
Request

​
contacts
array
required
Array of contact objects to create

​
Contact Object

​
externalId
string
required
Enginy’s internal lead ID. Use this to map responses back.
​
email
string
Professional or personal email address
​
firstName
string
Contact’s first name
​
lastName
string
Contact’s last name
​
phone
string
Mobile or direct phone number
​
company
string
Company name
​
title
string
Job title
​
linkedinUrl
string
LinkedIn profile URL
{
  "contacts": [
    {
      "externalId": "lead-123",
      "email": "john.doe@example.com",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+1234567890",
      "company": "Acme Inc",
      "title": "CEO",
      "linkedinUrl": "https://linkedin.com/in/johndoe"
    }
  ]
}

​
Response

​
results
array
required
Array of created contact mappings
​
results[].externalId
string
required
The externalId from the request
​
results[].crmId
string
required
Your CRM’s ID for this contact
{
  "results": [
    {
      "externalId": "lead-123",
      "crmId": "crm-contact-456"
    }
  ]
}
Enginy sends contacts in batches of up to 100 contacts per request.