---
title: "Cadastro de Contato"
method: POST
path: "/accounts/{account}/contacts"
---

# Cadastro de Contato

`POST /accounts/{account}/contacts`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev/baas/v2`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v2/accounts/{account}/contacts`
- Auth: OAuth 2

## Path parameters

- `account` string, required

## Request body

- object
  - `account` string, required: Identificador da conta à qual o contato será vinculado.
  - `clientRequestId` string, required: Id único da solicitação no cliente (até 200) — chave de idempotência
  - `alias` string: Apelido do contato (até 100; se enviado, não pode ser vazio)
  - `isFavorite` boolean
  - `type` 'MANUAL' | 'DICT'
  - `creditParty` object
    - `bank` string, required: Banco (ISPB)
    - `account` string, required: Conta do destinatário (até 20 caracteres)
    - `branch` string, required: Agência
    - `taxId` string, required: CPF/CNPJ
    - `accountType` 'CACC' | 'SVGS' | 'SLRY' | 'TRAN', required: Nome (até 140 caracteres)
    - `personType` 'NATURAL_PERSON' | 'LEGAL_PERSON', required
    - `key` string: Chave Pix
  - `name` string

## Response `200`

OK

- object
  - `status` string: Status do processamento da requisição. Retorna `SUCCESS` para cadastro comum concluído ou `PROCESSING` para solicitação de favorito em processamento.
  - `version` string: Versão do contrato da resposta.
  - `body` object
    - `contactId` string: Identificador único do contato.
    - `account` string: Identificador da conta vinculada ao contato.
    - `isFavorite` boolean: Indica se o contato já está efetivamente classificado como favorito. (Boolean - True ou False)
    - `alias` string: Nome ou apelido do contato.
    - `status` string: Status do contato. No exemplo, ACTIVE.
    - `clientRequestId` string: Identificador da solicitação informado pelo cliente.
    - `type` string: Tipo de cadastro do contato.
    - `creditParty` string: Objeto que contem os dados do destinatário, incluindo instituição, conta, agência, documento, nome, tipo de conta, chave Pix e tipo de pessoa.
    - `createdAt` string, date-time: Data e hora (date-time) de criação do contato.
    - `updatedAt` string, date-time
    - `message` string: Mensagem complementar retornada no fluxo assíncrono de cadastro como favorito. Não é exibida no cadastro comum.

## Other responses

- `400`: Bad Request
- `401`: Access Denied
- `500`: Internal Server Error

---

[API](https://skmtc.dev/celcoin/apis/baas-v2.md) - [All operations](https://skmtc.dev/celcoin/apis/baas-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/baas-v2/revisions/98ec6869c1f2?raw)