---
title: "Create Contact Import"
method: POST
path: "/v1/contacts/imports"
tags: ["Contacts"]
---

# Create Contact Import

`POST /v1/contacts/imports`

Import contacts from an uploaded CSV file. The file is stored and processed in the background; poll `GET /v1/contacts/imports/{id}` for status and counts. Requires API key with audience:write.

## Response `200`

Import accepted for background processing

- ApiResponseContactImport
  - `success` boolean, required
  - `data` object, nullable
    - `object` string
    - `id` string — Import job ID. Poll GET /v1/contacts/imports/{id} for status.
    - `status` string
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Missing required permissions or access denied

---

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