---
title: 4.2. Contatos
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/4.%20Dados%20Banc%C3%A1rios%20e%20Contatos/4.2.%20Contatos/
---
Gerenciamento dos contatos operacionais do cedente.

---

## Adicionar Contato

| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contatos` |

```` json title="Request Body"
{
  "nome": "Maria Financeiro",
  "email": "maria@empresaexemplo.com.br",
  "telefone": "47999887766"
}
````

```` json title="Response Body"
{
  "idContato": 5,
  "idEmpresa": 123,
  "status": "Contato adicionado com sucesso."
}
````

---

## Atualizar Contato

| Método | URL |
|--------|-----|
| ![PUT](https://img.shields.io/badge/PUT-orange) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contatos/{idContato}` |

```` json title="Request Body"
{
  "email": "maria.novo@empresaexemplo.com.br"
}
````

```` json title="Response Body"
{
  "idContato": 5,
  "status": "Contato atualizado com sucesso."
}
````

---

## Remover Contato

| Método | URL |
|--------|-----|
| ![DELETE](https://img.shields.io/badge/DELETE-red) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contatos/{idContato}` |

```` json title="Response Body"
{
  "status": "Contato removido com sucesso."
}
````

---

# Modelo de Dados

## Requisição — Contato

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|----------|
| `nome` | Texto (200) | ✅ | Nome do contato |
| `email` | Texto (200) | Opcional¹ | E-mail do contato |
| `telefone` | Texto (30) | Opcional¹ | Telefone do contato |

!!! note "Nota"
    ¹ Pelo menos um dos campos `email` ou `telefone` deve ser informado.

## Retorno

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `idContato` | Número | ID do contato |
| `idEmpresa` | Número | ID da empresa cedente |
| `status` | Texto | Mensagem de status da operação |