---
title: "Create"
method: POST
path: "/import/create"
tags: ["Contact Import Bulk (New)"]
---

# Create

`POST /import/create`

## Request

- Base URL: `https://netcoreapi-main-prod-us.netcorein.com/v5`
- URL: `https://netcoreapi-main-prod-us.netcorein.com/v5/import/create`
- Auth: API key in header `api-key`

The Contact Bulk Import API allows users to import contact records in bulk by providing a publicly accessible file URL.
Imports can be saved as drafts or published for processing.
 - This endpoint notifies only by email.
 - It does not support a callback/webhook URL.

## Headers

- `api-key` string, required
- `Content-Type` string, required

## Request body

- object
  - `data` object, required
    - `import_type` string, required: Defines the type of contact data being imported. **Required**, if import_type is contact. **Allowed Values**: - Anonymous: Contacts without identifying information. - Identified: Contacts with identifying information (e.g., name, email).
    - `file_url` string, required: The URL pointing to the file to be published. The file should be accessible via this URL. Required: Yes. **Allowed Formats**: CSV file hosted at a publicly accessible.
    - `contact_type` 'anonymous' | 'identified', required: Define whether the contact data is anonymous (no identifiers) or identified (includes name, email, etc.). Allowed values: 'anonymous', 'identified'.
    - `import_state` 'publish', required: Indicates the current state of the import process. **Required: Yes** Allowed Values: - **PUBLISH**: The import is finalized and ready for processing.
    - `ignore_new_attributes` boolean: Flag indicating whether to ignore new attributes present in the file that are not already defined in the system. Required: Optional. Allowed Values: true: Ignore new attributes and proceed with the import. false: Do not ignore new attributes (default). The system will return a "Bad Request" error if the file contains any new attributes.
    - `autocorrect` boolean: Flag indicating whether to automatically correct minor errors in the imported data. Required: Optional. Allowed Values: true: Enable autocorrection. false: Disable autocorrection (default).
    - `notify_callback` object: A JSON object containing email addresses used to receive updates about the import's status. This allows for notifications to be sent to specified recipients when the import process is completed or if any issues arise. Required: Optional. Allowed Values: A JSON object with an array of email addresses.
      - `notify` object, required: Specifies the email notification configuration for the import process. The configured email addresses receive notifications when the import is completed, including successful and failed imports. - **Webhook callbacks** are NOT supported by the upstream application. - `Allowed Values`: A JSON object with an array of email addresses.
        - `email` string[], required
    - `audience_details` object[]: A JSON array specifying additional details about the audience, including IDs and names of lists or segments associated with the imported data. This ID can act as udt_id in case of udt. Required: Optional if already provided during the draft stage. Compulsory in case of UDT.
      - `id` integer[], required: A list of audience IDs.

## Response `200`

Success

- object
  - `request_id` string, required
  - `description` string, required
  - `code` integer, required
  - `data` object[], required
    - `missing_attributes` object[]
      - `attribute_name` string, required
    - `file_name` string
    - `file_extension` string

## Other responses

- `400`
- `401`
- `500`

---

[API](https://skmtc.dev/netcorecloud/apis/contact-bulk-upload-api-new.md) - [All operations](https://skmtc.dev/netcorecloud/apis/contact-bulk-upload-api-new/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/contact-bulk-upload-api-new/revisions/1ceab03242b9?raw)