---
title: "Cadastra uma mensagem para um pré-cadastro"
method: POST
path: "/v3/comercial/precadastros/mensagens"
tags: ["Mensagens"]
---

# Cadastra uma mensagem para um pré-cadastro

`POST /v3/comercial/precadastros/mensagens`

> 🔒 **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)

Endpoint para cadastrar mensagens de um pré-cadastro específico.

## Headers

- `Authorization` string, required

## Request body

- object
  - `idprecadastro` integer
  - `mensagem` string
  - `exibir_imobiliaria` boolean
  - `enviar_email_imobiliaria` boolean
  - `exibir_corretor` boolean
  - `enviar_email_corretor` boolean
  - `exibir_correspondente` boolean
  - `enviar_email_correspondente` boolean
  - `arquivo_gravacao` string
  - `id_usuario` integer — Identificador do usuário que está enviando a mensagem (gestor, corretor, imobiliária ou correspondente). Campo opcional. Deve ser informado em conjunto com 'painel'; caso apenas um dos dois seja enviado, a requisição será rejeitada com erro 400.
  - `painel` 'gestor' | 'corretor' | 'imobiliaria' | 'correspondente' — Painel do usuário que está enviando a mensagem. Campo opcional. Deve ser informado em conjunto com 'id_usuario'; caso apenas um dos dois seja enviado, a requisição será rejeitada com erro 400. Quando informado, o remetente exibido na mensagem será o usuário do body; o histórico continuará registrando o usuário autenticado pelo token JWT.

## Response `200`

Operação realizada com sucesso

- PostStatusSucesso
  - `status` string
  - `code` integer
  - `data` object
    - `id` integer — Identificador da mensagem cadastrada
    - `aviso` string — Presente quando id_usuario foi informado mas não foi encontrado ou está inativo. O cadastro é realizado normalmente usando o usuário do token JWT.

## Other responses

- `403` — Token de acesso expirado/inválido.
- `404` — Não encontrado!
- `500` — Erro interno!

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/revisions/42bf5add8bf3/schema)