> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salez.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Contatos

> Operações da API Salez para consultar, criar e atualizar contatos, além de acessar os agendamentos relacionados a cada registro.

O módulo **Contatos** reúne as operações para consultar e gerenciar os dados de contatos da Salez e verificar seus agendamentos.

> [!NOTE]
>
> **Como obter o token:** na Salez, acesse **Configurações > Integrações Privadas** e crie ou consulte uma integração autorizada. A disponibilidade desse menu depende do nível de acesso e das permissões do usuário.

## Autenticação e headers

As requisições utilizam o cabeçalho `Authorization: Bearer <token>` e a versão `v3`.

```http theme={"system"}
Authorization: Bearer <token>
Version: v3
Content-Type: application/json
```

O `Content-Type: application/json` é usado nas operações que enviam um corpo JSON, como criação e atualização. Substitua apenas `<token>` pelo token real. Os demais valores acima são literais.

## Permissões necessárias

| Operação | Escopo |
| - | - |
| Consultar contato | `contacts.readonly` |
| Localizar por e-mail ou telefone | `contacts.readonly` |
| Consultar contatos por empresa | `contacts.readonly` |
| Criar contato | `contacts.write` |
| Atualizar contato | `contacts.write` |
| Excluir contato | `contacts.write` |
| Criar ou atualizar contato | `contacts.write` |
| Consultar agendamentos do contato | `contacts.readonly` |

## Categorias

> [card] [Gerenciamento de contatos](https://docs.salez.com.br/contatos/gerenciamento)
>
> Consulte, crie e atualize os dados cadastrais de contatos.

> [card] [Agendamentos](https://docs.salez.com.br/contatos/agendamentos)
>
> Consulta de agendamentos associados a um contato.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.