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

> Create new companies 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 companies in your CRM when exporting.

## Request

<ParamField body="companies" type="array" required>
  Array of company objects to create
</ParamField>

### Company Object

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

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

<ParamField body="domain" type="string">
  Company domain (e.g., "acme.com")
</ParamField>

<ParamField body="industry" type="string">
  Industry classification
</ParamField>

<ParamField body="employeeCount" type="number">
  Number of employees
</ParamField>

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

<RequestExample>
  ```json theme={null}
  {
    "companies": [
      {
        "externalId": "company-123",
        "name": "Acme Corporation",
        "domain": "acme.com",
        "industry": "Technology",
        "employeeCount": 500,
        "linkedinUrl": "https://linkedin.com/company/acme"
      }
    ]
  }
  ```
</RequestExample>

## Response

<ResponseField name="results" type="array" required>
  Array of created company 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 company
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "results": [
      {
        "externalId": "company-123",
        "crmId": "account_4k8j2m"
      }
    ]
  }
  ```
</ResponseExample>

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