Meu Dinheiro · API
Contatos

Cria um contato

POST
/contatos

Cria um contato ativo. nome, tipo_pessoa e tipo_contato são obrigatórios; o documento é validado (CPF na pessoa física, CNPJ, inclusive alfanumérico, na jurídica) e gravado sem pontuação. RG, nascimento, inscrições, observação, campos personalizados e anexos ficam fora do contrato. Exige o papel Editor ou um papel com permissão de editar Contatos. A resposta tem o mesmo formato do GET /contatos/{id}.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Corpo da requisição

application/json
  1. body
nome*string
Tamanholength <= 200
razao_social?|
Tamanholength <= 200
tipo_pessoa*TipoPessoa
Valores"fisica""juridica"
tipo_contato*TipoContato
Valores"cliente""fornecedor""ambos"
categoria_id?|

Categoria de contato do workspace; nulo remove. Inexistente responde 422.

documento?|

CPF (pessoa física) ou CNPJ (jurídica, aceita o alfanumérico), com ou sem pontuação; validado.

email?|
Tamanholength <= 200
telefones?array<>
Itensitems <= 3
endereco?|

Os campos ausentes ficam vazios; nulo apaga o endereço.

Corpo da resposta

O contato criado.

application/json
  1. response
id*integer
nome*string
razao_social*string|null
tipo_pessoa*TipoPessoa
Valores"fisica""juridica"
tipo_contato*TipoContato
Valores"cliente""fornecedor""ambos"
status*StatusCadastro

inactive: desativado no app, segue nos lançamentos antigos.

Valores"active""inactive"
categoria*|

A categoria de contato (o agrupamento que a área define), não a de lançamento.

documento*|

CPF ou CNPJ, só letras e números (o CNPJ pode ter letras desde 2026).

email*string|null
telefones*array<string>

Até três, como foram digitados.

endereco*|

Nulo quando o contato não tem endereço nenhum.

curl -X POST "https://example.com/contatos" \  -H "Content-Type: application/json" \  -d '{    "nome": "string",    "tipo_pessoa": "fisica",    "tipo_contato": "cliente"  }'
{  "id": 9120,  "nome": "Mercado Bom Preço",  "razao_social": "Bom Preço Comércio de Alimentos Ltda",  "tipo_pessoa": "fisica",  "tipo_contato": "cliente",  "status": "active",  "categoria": {    "id": 0,    "nome": "Atacado"  },  "documento": "12ABC34501DE35",  "email": "string",  "telefones": [    "(11) 3333-4444"  ],  "endereco": {    "logradouro": "string",    "numero": "string",    "complemento": "string",    "bairro": "string",    "cidade": "string",    "uf": "string",    "cep": "string"  }}

Lista os contatos GET

Os clientes e fornecedores do workspace, com documento, e-mail, telefones e endereço. Inclui os inativos. `tipo_contato=cliente` traz também quem é cliente **e** fornecedor (`ambos`); o mesmo vale para `fornecedor`.

Um contato GET

Contato de outro workspace, ou inexistente, responde 404.