---
title: "Bulk creates, or bulk updates, contacts with merge options. The ID of returned object can be used to query import progress."
method: POST
path: "/v2/contacts/import/with-merge-option/{mergeOption}"
tags: ["ApiContactImport"]
---

# Bulk creates, or bulk updates, contacts with merge options. The ID of returned object can be used to query import progress.

`POST /v2/contacts/import/with-merge-option/{mergeOption}`

## Request

- Base URL: `https://api.dotdigital.com`
- URL: `https://api.dotdigital.com/v2/contacts/import/with-merge-option/{mergeOption}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/dotdigital/apis/apiconnector-com/docs/v2/contacts/import/with-merge-option/:mergeOption/post.ts> (a function with typed inputs; its response is checked against the schema)

This API works on both contact data fields and marketing preferences. Import format can either be CSV or Excel. Must include one column called "Email". Passing a valid "mergeOption" parameter is compulsory. Any other columns will attempt to map to your custom data fields.

## Path parameters

- `mergeOption` 'Overwrite' | 'OnlyOverwriteIfNotEmpty' | 'OnlyOverwriteIfContactDataNotPopulated' | 'NotAvailableInThisVersion', required

## Request body

- ApiFileMedia
  - `fileName` string, nullable
  - `data` string, byte, nullable

## Response `202`

- ApiContactImport
  - `id` string, guid
  - `status` 'Finished' | 'NotFinished' | 'RejectedByWatchdog' | 'InvalidFileFormat' | 'Unknown' | 'Failed' | 'ExceedsAllowedContactLimit' | 'NotAvailableInThisVersion'

---

[API](https://skmtc.dev/dotdigital/apis/apiconnector-com.md) - [All operations](https://skmtc.dev/dotdigital/apis/apiconnector-com/llms.txt) - [OpenAPI document](https://skmtc.dev/dotdigital/apis/apiconnector-com/revisions/391b93e8d24a?raw)