---
title: "Global Import Companies"
method: POST
path: "/companies/entries"
tags: ["companies"]
---

# Global Import Companies

`POST /companies/entries`

Import companies with global custom field values

## Request body

- CompanyListEntriesBatchImportInput
  - `entries` CompanyListEntryInput[], required
    - `company_urn` string, nullable
    - `canonical` CompanyCanonicalParameter
      - `linkedin_url` string, nullable
      - `crunchbase_url` string, nullable
      - `pitchbook_url` string, nullable
      - `website_url` string, nullable
    - `values` CompanyFieldInputValue[]
      - `custom_field_urn` union, required
        - string
        - string
        - string
      - `data` union, required
        - CheckboxListCustomFieldValue
          - `value` boolean, nullable
        - NumberListCustomFieldValue
          - `value` number, nullable
        - TextListCustomFieldValue
          - `value` string, nullable
        - SingleListSelectCustomFieldValue
          - `value` string, nullable
        - MultiSelectListCustomFieldValue
          - `value` string[]
        - PersonSelectCustomFieldValue
          - `value` string[]
        - DateListCustomFieldValue
          - `value` string, nullable
        - WebsiteListCustomFieldValue
          - `value` string, nullable
        - StatusListCustomFieldValue
          - `value` string, nullable
        - PersonSelectCustomFieldValueInput
          - `value` union[]
            - union
              - …
        - RecordReferenceListCustomFieldValue
          - `value` string[]
    - `external_display_name` string, nullable
    - `external_id` string, nullable
    - `external_entry` UnifiedExternalCompanyListEntryModel
      - `id` string, nullable
      - `list_id` string, required
      - `target_list_urn` string, required
      - `entity_id` string, nullable
      - `entity_type` string, nullable
      - `added_at` string, nullable
      - `updated_at` string, nullable
      - `canonical` CompanyCanonicalParameter
        - `linkedin_url` string, nullable
        - `crunchbase_url` string, nullable
        - `pitchbook_url` string, nullable
        - `website_url` string, nullable
      - `label` string, nullable
      - `integration_provider` string, required

## Response `200`

Successful Response

- ImportCompaniesCanonicalsOutput
  - `user_companies_import_urn` string, required
  - `total_companies_count` integer, required
  - `companies_found_count` integer, required
  - `companies_not_found_count` integer, required
  - `companies_invalid_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/harmonic/apis/harmonic-ai-public-api.md) · [All operations](https://skmtc.net/harmonic/apis/harmonic-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harmonic/harmonic-ai-public-api/revisions/0edae4154f8f/schema)