---
title: "Global Import People"
method: POST
path: "/persons/entries"
tags: ["persons"]
---

# Global Import People

`POST /persons/entries`

Import people with global custom field values

## Request body

- PersonListEntriesBatchImportInput
  - `entries` PersonListEntryInput[], required
    - `person_urn` string, nullable
    - `canonical` PersonCanonicalParameter
      - `linkedin_url` string, nullable
      - `email` string, nullable
    - `values` PersonFieldInputValue[]
      - `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[]
    - `created_at` string, date-time, nullable

## Response `200`

Successful Response

- ImportPeopleCanonicalsOutput
  - `user_people_import_urn` string, required
  - `total_people_count` integer, required
  - `people_found_count` integer, required
  - `people_not_found_count` integer, required
  - `people_invalid_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-19** `fbef1ba78f96` — 1 breaking
  - removed `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue, #/components/schemas/OwnerSelectCustomFieldValueInput` from the `entries/items/values/items/data` request property `anyOf` list
- **2026-08-19** `2100d53a6676` — 1 info
  - added `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue, #/components/schemas/OwnerSelectCustomFieldValueInput` to the `entries/items/values/items/data` request property `anyOf` list
- **2026-07-26** `fcf35c98e097` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/changes/persons/entries/post.md)

---

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