---
title: "Cadastra um novo cliente na API do Rede Vistorias"
method: POST
path: "/clients"
tags: ["Clientes"]
---

# Cadastra um novo cliente na API do Rede Vistorias

`POST /clients`

Novos clientes podem ser cadastrados diretamente pela API disponibilizada pela Rede Vistorias, passando os dados informados abaixo.
![Diagrama de criação do cliente através da API](../images/new_client.jpg)
<br />Todavia, caso o cliente já exista em nosso banco de dados, um erro de conflito será gerado.

## Headers

- `Authorization` string, required

## Request body

- union
  - ClientPessoaFisica
    - `client_type` string, required — pf para Pessoa Física
    - `document` string, required — Identificador do cliente, CPF para pessoas físicas.
    - `name` string, required — Nome completo do usuário, em caso de pessoa física.
    - `cellphone` string — Telefone celular do usuário, se houver.
    - `phone` string, required — Telefone do usuário.
    - `email` string, required — Email do usuário.
    - `website` string — Site do cliente, se houver.
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `hooks` Hook[], required
      - `type` 'webhook'
      - `url` string — URL do endpoint que receberá o webhook com as atualizações do pedido.
  - ClientPessoaJuridica
    - `client_type` string, required — pj para Pessoa Jurídica
    - `document` string, required — Identificador do cliente: CNPJ, para pessoas jurídicas.
    - `name` string, required — Razão social, no caso de pessoa jurídica.
    - `cellphone` string — Telefone celular do usuário, se houver.
    - `phone` string, required — Telefone do usuário.
    - `email` string, required — Email do usuário.
    - `website` string — Site do cliente, se houver.
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `responsible` Responsible, required — Dados referentes à pessoa física responsável pela empresa.
      - `document` string, required — CPF do responsável da empresa.
      - `name` string, required — Nome completo do responsável da empresa.
      - `cellphone` string — Telefone celular do responsável da empresa, se houver.
      - `phone` string — Telefone do responsável da empresa.
      - `email` string — Email do responsável da empresa.
      - `address` Address
        - `street` string, required
        - `number` string, required
        - `complement` string
        - `zipcode` string, required
        - `neighborhood` string, required
        - `city` string, required
        - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `hooks` Hook[]
      - `type` 'webhook'
      - `url` string — URL do endpoint que receberá o webhook com as atualizações do pedido.

## Response `201`

Created

- object
  - `api_key` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Already existing client

---

[API](https://skmtc.net/redevistorias/apis/rede-vistorias-erp-api.md) · [All operations](https://skmtc.net/redevistorias/apis/rede-vistorias-erp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redevistorias/rede-vistorias-erp-api/versions/0be35aeec025/schema)