---
title: "Criar Invite com Multi Case"
method: POST
path: "/api/v1/account/multicase/invite"
tags: ["Invites"]
---

# Criar Invite com Multi Case

`POST /api/v1/account/multicase/invite`

Cria invite para múltiplos scripts em uma única jornada.

## Request body

- CreateMultiCaseInvitePayload
  - `availableAt` string — Data de quando o invite estará disponível. Se não informado, usa-se a data/hora de criação. ISO 8601 com milissegundos (YYYY-MM-DDTHH:mm:ss.SSS)
  - `customer` CustomerInvitePayload
    - `cpf` string, required — CPF do cliente que realizará o vídeo agreement
    - `fields` CustomerField[], required — Campos adicionais do cliente no fluxo (pelo menos um item; `label` e `value` obrigatórios em cada um)
      - `label` string, required — Label do campo no formulário do cliente
      - `private` boolean — Se `true`, o campo não é exibido no front-end, mas é devolvido à empresa ao final da jornada
      - `value` string, required — Valor associado ao label
    - `identificationImage` string — Imagem em base64 ou URL para identificação (ex.: selfie, RG, CNH)
    - `name` string — Nome do cliente (usado se o cliente ainda não existir e for criado nesta operação)
  - `expiresAt` string, required — Data de expiração do invite (ISO 8601 com milissegundos)
  - `script` ScriptCasesInvitePayload
    - `cases` InteractionScriptCase[] — Lista de scripts que o cliente poderá (ou não) percorrer ao longo da jornada do invite
      - `fields` ScriptField[] — Lista de pares chave-valor utilizados para substituir variáveis no script. Ex.: se o script contém "Essa é a {{empresa}}", ao definir a chave empresa com o valor Nuvidio, a mensagem final será "Essa é a Nuvidio"
        - `displayName` string — Nome amigável que poderá ser exibido no front-end sempre que necessário
        - `label` string, required — Label da variável que consta no script
        - `private` boolean — Informe `true` se é um campo de controle que deseja receber de volta ao final do processamento da jornada
        - `value` string, required — Valor da variável que consta no script. Na criação do roteiro ocorrerá a troca do que consta em `{{label}}` pelo value informado
      - `identifier` string — Identificador para controle e agrupamento. Se não informado, um valor aleatório é gerado. Ex.: Produto XPTO, Proposta 4547
      - `scriptReference` string, required — Informe a referência do script que deve ser incorporado ao fluxo caso as condições sejam atendidas. Pode ser um script_id (UUID) ou um reference válido. Ex.1: 878a4881-8fd3-46ce-91ad-06f37256b62e — Ex.2: script_cartao_2
    - `journey` JourneyScriptCase
      - `fields` ScriptField[] — Lista de pares chave-valor utilizados para substituir variáveis no script. Ex.: se o script contém "Essa é a {{empresa}}", ao definir a chave empresa com o valor Nuvidio, a mensagem final será "Essa é a Nuvidio"
        - `displayName` string — Nome amigável que poderá ser exibido no front-end sempre que necessário
        - `label` string, required — Label da variável que consta no script
        - `private` boolean — Informe `true` se é um campo de controle que deseja receber de volta ao final do processamento da jornada
        - `value` string, required — Valor da variável que consta no script. Na criação do roteiro ocorrerá a troca do que consta em `{{label}}` pelo value informado
      - `scriptReference` string, required — Informe a referência do script que deve ser incorporado ao fluxo caso as condições sejam atendidas. Pode ser um script_id (UUID) ou um reference válido. Ex.1: 878a4881-8fd3-46ce-91ad-06f37256b62e — Ex.2: script_cartao_2
  - `timezone` string — Se não informado, o default será America/Sao_Paulo

## Response `201`

Invite multicase criado com sucesso

- CreateInviteResponse
  - `accountId` string — Conta associada (quando retornado)
  - `availableAt` string — Início de disponibilidade efetivo do invite
  - `customerJourneyType` string — Tipo de jornada do script (ex.: agreement)
  - `expiredInviteUrl` string — URL quando o invite expirar
  - `expiresAt` string — Expiração do invite
  - `helpUrl` string — URL de ajuda
  - `invalidDataUrl` string — URL para dados inválidos no fluxo
  - `inviteId` string — ID do invite criado
  - `inviteUrl` string — URL do convite para o cliente
  - `successUrl` string — URL de sucesso ao finalizar
  - `termsUrl` string — URL dos termos
  - `timezone` string — Timezone aplicado
  - `voiceGender` string — Gênero de voz da IA quando aplicável

## Other responses

- `400` — Regra de negócio inválida (ex. jornada do script, cliente) ou erro de aplicação
- `403` — Script desabilitado, não encontrado ou sem permissão para esta conta
- `422` — JSON inválido ou corpo não atende à validação (script, cliente, datas, fields)
- `500` — Erro inesperado ao criar o invite multicase

---

[API](https://skmtc.net/nuvidio/apis/nuvidio-openapi.md) · [All operations](https://skmtc.net/nuvidio/apis/nuvidio-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nuvidio/nuvidio-openapi/versions/a262554413c2/schema)