---
title: "Criar cliente"
method: POST
path: "/v1/accountingfirms/{accountingFirmId}/customers"
---

# Criar cliente

`POST /v1/accountingfirms/{accountingFirmId}/customers`

## Request

- Base URL: `https://api.nibo.com.br/accountant/api`
- URL: `https://api.nibo.com.br/accountant/api/v1/accountingfirms/{accountingFirmId}/customers`
- Auth: none required

Permite criar um cliente para um determinado escritório.

## Path parameters

- `accountingFirmId` string, required

## Headers

- `X-API-Key` string
- `X-User-Id` string

## Request body

- object
  - `Name` string: Nome do cliente.
  - `Code` string: Código do cliente.
  - `IsDailyAgendaEmailEnabled` boolean: Permite enviar e-mail com lembrete no dia de vencimento de impostos
  - `AllowsAnonymousAccessToFiled` boolean: Permitir visualização de documentos do cliente sem login.
  - `DocumentNumber` string: Número de documento do cliente (CPF ou CNPJ).
  - `Cei` string: CEI do cliente.
  - `Caepf` string: CAEPF do cliente (Somente para Pessoa física).
  - `stateRegistration` string: Inscrição Estadual do cliente.
  - `cityRegistration` string: Inscrição Municipal do cliente.
  - `TaxRegime` integer: Regime tributário do cliente.
  - `BusinessActivity` integer: Ramo de atividade do cliente.
  - `CustomerAddress` unknown[]: Endereço do cliente.
    - unknown

## Response `200`

200

- object
  - `Id` string
  - `Name` string
  - `Code` string
  - `NiboDocsEnabled` string
  - `Address` object
    - `City` string
    - `Complement` string
    - `District` string
    - `State` string
    - `Number` string
    - `PostalCode` string
    - `Street` string
  - `Cnaes` object[]
  - `Tags` object[]
  - `BusinessActivity` string
  - `DocumentNumber` string
  - `DocumentType` string
  - `IsOwnAccountant` string
  - `TaxRegime` string
  - `CreatedAt` string
  - `CreatedBy` string
  - `InactiveDate` string
  - `InactiveUser` string

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `500`: 500

---

[API](https://skmtc.dev/nibo/apis/api-contador.md) - [All operations](https://skmtc.dev/nibo/apis/api-contador/llms.txt) - [OpenAPI document](https://skmtc.dev/nibo/apis/api-contador/revisions/4896f7f3499f?raw)