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

# Enviar Convite

`POST /api/v1/invitation`

**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)</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.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)