---
title: "Enviar Convite"
method: POST
path: "/api/v1/invitation"
tags: ["Convites"]
---

# Enviar Convite

`POST /api/v1/invitation`

## Request

- Base URL: `https://api-clientes.meuk8.com.br`
- URL: `https://api-clientes.meuk8.com.br/api/v1/invitation`
- Auth: HTTP bearer

**Convites- Enviar Convite**<br/>Permite que seja convidado novos usuários para se cadastrarem e utilizarem a plataforma. Ao enviar um convite, é fornecido ao destinatário um link único que o direciona para o processo de criação de conta.<br/><br/>**Funcionalidades do Endpoint:**<br/>-   **Criação de Convites Individuais:** Envie convites personalizados para cada usuário, definindo seu endereço de email e outros atributos relevantes.<br/>-   **Validade dos Convites:** Estabeleça um período de tempo para que os convites sejam válidos, evitando que links expirados sejam utilizados.<br/>-   **Monitoramento de Conversões:** Acompanhe a taxa de conversão dos convites enviados, identificando quantos usuários se cadastraram através desse método.<br/><br/>**Requisição**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th><th>Obrigatoriedade</th></tr></thead><tbody><tr><td>name</td><td>Texto</td><td>Nome do usuário cadastrado</td><td>Sim</td></tr><tr><td>cnpj</td><td>Texto</td><td>CNPJ do usuário cadastrado</td><td>Sim</td></tr><tr><td>email</td><td>Texto</td><td>E-mail do usuário cadastrado</td><td>Sim</td></tr><tr><td>flow</td><td>Texto</td><td>Tipo de conta (conta_rapida, conta_rapida_cobranca, conta_movimento)</td><td>Não</td></tr><tr><td>client_type</td><td>Texto</td><td>Categoria da conta (cedente, cessionario)</td><td>Não</td></tr></tbody></table><br/><br/>**Resposta**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Message</td><td>Texto</td><td>Mensagem de envio de convite</td></tr></tbody></table>

## Headers

- `client-id` string, uuid, required

## Request body

- object
  - `name` string
  - `cnpj` string
  - `email` string, email
  - `flow` string
  - `client_type` string

## Response `200`

Invitation created successfully

- object
  - `message` string

## Other responses

- `401`: Invalid client data.
- `403`: Invalid token.
- `422`: Invalid input fields.

---

[API](https://skmtc.dev/meuk8/apis/k8-api-conta.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-api-conta/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-api-conta/revisions/edfe92cb11ff?raw)