---
title: "Cadastrar contato"
method: POST
path: "/v1/contacts"
tags: ["Contacts"]
---

# Cadastrar contato

`POST /v1/contacts`

Cria um contato após validar o número no WhatsApp.

**Obrigatórios:** `connection` (UUID — `id` de GET /v1/connections), `number` (DDI + DDD + telefone ).

**Opcionais:** `name`, `email`, `agent`, `user`, `status`.

## Request body

- CreateContactDto
  - `connection` string, uuid, required — ID da conexão — o mesmo `id` retornado em GET /v1/connections.
  - `number` string, required — Número para validação no WhatsApp (DDI + dígitos, com ou sem +).
  - `name` string — Nome exibido no chat (string; não envie objeto).
  - `email` string — E-mail associado ao contato (string).
  - `agent` string, uuid — Agente de IA — mesmo `id` que recebe em GET /v1/agents.
  - `user` string, uuid — Usuário humano — mesmo campo `user` que recebe em GET /v1/users.
  - `status` string, uuid — Label de status — mesmo campo `status` na resposta de chat. GET /v1/settings/status.

## Response `200`

`exist: false` se o número não for WhatsApp válido; caso contrário `exist`, `id` e `created`.

- CreateContactResponseDto
  - `exist` boolean, required — Indica se o número existe no WhatsApp.
  - `id` string, uuid — Presente quando `exist` é true: UUID do chat/contato (`Chat.id`).
  - `created` boolean — Presente quando `exist` é true: true se o chat foi criado nesta chamada.

## Other responses

- `400` — Corpo inválido — validação de campos (ex.: `agent` / `user` / `status` inexistentes no workspace)
- `401` — Não autorizado — chave de empresa inválida ou ausente
- `404` — Conexão não encontrada para este workspace
- `500` — Erro ao criar ou atualizar o chat
- `503` — Erro ao validar o número WhatsApp

---

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