# Create companies

Create one or more company records. Optionally assign them to lists and a data source.

Endpoint: POST /leads/api/companies
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `companies` (array, required)
    Array of company objects to create.

  - `companies.name` (string)
    Example: "Acme Inc"

  - `companies.domain` (string)
    Example: "acme.com"

  - `companies.website` (string)
    Example: "https://acme.com"

  - `companies.linkedin` (string)
    Example: "acme-inc"

  - `companies.industry` (string)
    Example: "Technology"

  - `companies.employees_range` (string)
    Example: "51-200"

  - `companies.hq_raw_address` (string)
    Example: "San Francisco, CA"

  - `list_uuids` (array)
    List UUIDs to assign companies to.

  - `data_source_uuid` (string)

## Response 200 fields (application/json):

  - `uuid` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `team_id` (integer)

  - `user_id` (integer,null)

  - `data_source_uuid` (string,null)

  - `lead_status_uuid` (string,null)
    Pipeline stage UUID.

  - `name` (string)
    Example: "Acme Inc"

  - `domain` (string,null)
    Example: "acme.com"

  - `website` (string,null)
    Example: "https://acme.com"

  - `ln_id` (integer,null)
    LinkedIn company numeric ID.

  - `linkedin` (string,null)
    Example: "acme-inc"

  - `facebook` (string,null)

  - `twitter` (string,null)

  - `phone` (string,null)

  - `hq_raw_address` (string,null)
    Example: "San Francisco, CA, USA"

  - `hq_location` (array,null)

  - `logo_url` (string,null)

  - `industry` (string,null)
    Example: "Technology"

  - `employees_range` (string,null)
    Example: "51-200"

  - `year_established` (integer,null)
    Example: 2015

  - `about` (string,null)

  - `lists` (array,null)
    List UUIDs.

  - `tags` (array,null)
    Tag UUIDs.

  - `status` (string)

  - `last_enrich_at` (string,null)

  - `created_at` (string,null)

  - `updated_at` (string,null)