---
title: "Create Import"
method: POST
path: "/import"
tags: ["Import"]
---

# Create Import

`POST /import`

Create a new import

## Query parameters

- `select` string

## Request body

- object
  - `type` 'contact_details' | 'deal_details' | 'appointment_details', public.import_type — Type of import
  - `payload` object, nullable — Payload of import for small imports
  - `contact_list_id` string, uuid, nullable — ID of the contact list that the contacts should be assigned to
  - `contact_list_external_id` string, text, nullable — External ID of the contact list that the contacts should be assigned to
  - `allow_deal_reassignment` boolean, nullable — If true, a deal currently assigned to another contact will be re-assigned
  - `allow_appointment_reassignment` boolean, nullable — If true, an appointment currently assigned to another contact will be re-assigned

## Response `200`

The updated Import object

- Import
  - `id` string, uuid — Import ID
  - `created_at` string, timestamp with time zone — Import creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `type` 'contact_details' | 'deal_details' | 'appointment_details', public.import_type — Type of import
  - `payload` object, nullable — Payload of import for small imports
  - `contact_list_id` string, uuid, nullable — ID of the contact list that the contacts should be assigned to
  - `contact_list_external_id` string, text, nullable — External ID of the contact list that the contacts should be assigned to
  - `failed_url` string, text, nullable — URL to download the failed contacts
  - `payload_url` string, text, nullable — URL to download the payload for large imports
  - `total_count` integer, nullable — Total number of contacts in the import
  - `success_count` integer, nullable — Number of contacts successfully imported
  - `failed_count` integer, nullable — Number of contacts that failed to import
  - `reference_id` string, text, nullable — An optional reference ID provided during the import
  - `hints` object, nullable — Optional hints for the import, e.g. to indicate if a field was stolen from another contact. We only store the first 20 hints.
  - `allow_deal_reassignment` boolean, nullable — If true, a deal currently assigned to another contact will be re-assigned
  - `allow_appointment_reassignment` boolean, nullable — If true, an appointment currently assigned to another contact will be re-assigned

## Other responses

- `201` — The Import was created
- `204` — No Content

---

[API](https://skmtc.dev/getmateo/apis/mateo-api.md) · [All operations](https://skmtc.dev/getmateo/apis/mateo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getmateo/mateo-api/revisions/22a9b3b009d1/schema)