> ## 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.

# Create contacts

> Create new contacts in your CRM

<Card title="Your Implementation Required" icon="triangle-exclamation" color="#f59e0b">
  This endpoint must be implemented on **your server**
</Card>

Enginy calls this endpoint to create contacts in your CRM when exporting leads.

## Request

<ParamField body="contacts" type="array" required>
  Array of contact objects to create
</ParamField>

### Contact Object

<ParamField body="externalId" type="string" required>
  Enginy's internal lead ID. Use this to map responses back.
</ParamField>

<ParamField body="email" type="string">
  Professional or personal email address
</ParamField>

<ParamField body="firstName" type="string">
  Contact's first name
</ParamField>

<ParamField body="lastName" type="string">
  Contact's last name
</ParamField>

<ParamField body="phone" type="string">
  Mobile or direct phone number
</ParamField>

<ParamField body="company" type="string">
  Company name
</ParamField>

<ParamField body="title" type="string">
  Job title
</ParamField>

<ParamField body="linkedinUrl" type="string">
  LinkedIn profile URL
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "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"
      }
    ]
  }
  ```
</RequestExample>

## Response

<ResponseField name="results" type="array" required>
  Array of created contact mappings
</ResponseField>

<ResponseField name="results[].externalId" type="string" required>
  The `externalId` from the request
</ResponseField>

<ResponseField name="results[].crmId" type="string" required>
  Your CRM's ID for this contact
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "results": [
      {
        "externalId": "lead-123",
        "crmId": "crm-contact-456"
      }
    ]
  }
  ```
</ResponseExample>

<Note>Enginy sends contacts in batches of up to **100 contacts** per request.</Note>