---
title: "Cadastrar um agendamento"
method: POST
path: "/cvbot/agendamentos"
tags: ["Agendamentos"]
---

# Cadastrar um agendamento

`POST /cvbot/agendamentos`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1`
- URL: `https://integracao.cvcrm.com.br/api/v1/cvbot/agendamentos`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

## Request body

- CadastroAgendamento
  - `idagendamento` integer, required: Id do agendamento
  - `idpessoa` integer, required: Id da pessoa
  - `idunidade` integer: Id da unidade
  - `idempreendimento` integer, required: Id do empreendimento da unidade informada
  - `data` string: Data para o agendamento em formato DD/MM/YYYY
  - `hora` string, required: Hora do agendamento em formato HH:MM

## Response `201`

Agendamento cadastrado com sucesso

- CadastroAgendamentoSucesso
  - `id` integer: Id da vistoria ou da visita criada
  - `empreendimento` string: Nome do empreendimento
  - `unidade` string: Nome da unidade
  - `tipo` string: Tipo do Agendamento criado: Vistoria, Visita ou Visita de Financiamento
  - `motivo` string: Motivo da visita
  - `data` string: Data marcada para o agendamento
  - `horario` string: Horário marcado para o agendamento
  - `vistoriador` string: Vistoriador do agendamento
  - `sucesso` boolean

## Other responses

- `400`: Requisição incorreta!
- `422`: Ocorreu um erro inesperado, por favor tente mais tarde.

---

[API](https://skmtc.dev/cvcrm/apis/comunica-es.md) - [All operations](https://skmtc.dev/cvcrm/apis/comunica-es/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/comunica-es/revisions/ee8372f78a0b?raw)