---
title: "Find or Create Contact by Phone"
method: POST
path: "/v3/contacts/find-or-create"
tags: ["Contatos"]
---

# Find or Create Contact by Phone

`POST /v3/contacts/find-or-create`

Busca o contato por qualquer um dos telefones informados (com e sem DDI e nono dígito) e o cria se não existir.

## Request body

- PhoneBookContactDto
  - `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/find-or-create/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)