---
title: "Criar um cliente"
method: POST
path: "/api/management/customers"
tags: ["customers"]
---

# Criar um cliente

`POST /api/management/customers`

Criar um novo cliente.

## Request body

- object
  - `name` string, required — Nome do contato
  - `role` string — Cargo do contato
  - `email` string, email — E-mail do contato
  - `phone` string — Telefone do contato
  - `description` string — Descrição do contato
  - `customers` object — Clientes vinculados ao contato. Envie to_add (clientes a adicionar) e to_rem (clientes a remover).
    - `to_add` string[], required — IDs dos clientes a adicionar
    - `to_rem` string[], required — IDs dos clientes a remover
  - `tags` object — Etiquetas do contato. Envie to_add (etiquetas a adicionar) e to_rem (etiquetas a remover).
    - `to_add` union[], required — Etiquetas a adicionar: use id para vincular etiqueta existente ou name (e opcionalmente color) para criar nova
      - union
        - object
          - `id` string, uuid, required — ID da etiqueta existente
        - object
          - `name` string, required — Nome da nova etiqueta
          - `color` string — Cor em hex (ex: #FF0000)
    - `to_rem` object[], required — Etiquetas a remover
      - `id` string, uuid, required — ID da etiqueta a remover
  - `form_answers` object[] — Respostas do formulário dinâmico
    - `id` integer, required — ID da pergunta do formulário (form_edge id)
    - `answer` string, required — Resposta para a pergunta

## Response `200`

Sucesso (CNPJ)

## Other responses

- `201` — Sucesso (CNPJ)

---

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