---
title: "Import Contacts"
method: POST
path: "/v3/contacts/import"
tags: ["Contatos"]
---

# Import Contacts

`POST /v3/contacts/import`

Importa contatos da agenda do celular em lotes de até 500. Contatos com telefone já cadastrado são ignorados; os novos são criados em segundo plano.

## Request body

- ImportContactsDto
  - `contacts` PhoneBookContactDto[], required
    - `name` string
    - `phones` string[], required — Telefones do contato em ordem de preferência. O primeiro válido é salvo; todos são usados para encontrar um contato existente.

## Response `201`

## Changes

- **2026-09-24** `6a8e568bb88a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v3/contacts/import/post.md)

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)