---
title: "Criar conta"
method: POST
path: "/api/v1/account"
tags: ["Contas"]
---

# Criar conta

`POST /api/v1/account`

A organização pode ter várias contas, permitindo separar scripts e convites por produto, time ou necessidade específica.
O organizationId da conta é definido a partir do token (credenciais da organização).

## Request body

- CreateAccountPayload
  - `biometricProvider` 'idwall' | 'serpro' — Provedor biométrico principal
  - `cloudConfig` CloudConfigPayload
    - `access_key` string
    - `container` string
    - `provider` string
    - `region` string
    - `secret_key` string
    - `session_token` string
  - `color` string — Cor em hexadecimal para personalização visual. Necessário informar `color` ou `styleId`
  - `companyId` string — Identificador da empresa no Nuvidio Call para redirecionamento em transbordo
  - `contractedIntelligences` string[] — Lista de inteligências contratadas
  - `id` string — Identificador da conta
  - `logo` string, required — Logo da conta (URL ou Base64)
  - `name` string, required — Nome da conta
  - `organizationId` string — Identificador da organização. Substituído pelo ID da organização do token
  - `slug` string, required — Identificador amigável para o cliente no acesso ao convite
  - `styleId` string — ID do template de estilo. Alternativa ao `color`
  - `transcriptionProvider` 'bot_runner' — Provedor de transcrição. Padrão: bot_runner
  - `videoProvider` 'daily' — Provedor de vídeo. Padrão: daily
  - `whatsappConfig` WhatsAppConfigPayload
    - `apiKey` string — Chave de API da plataforma de envio
    - `apiSecret` string — Segredo da API da plataforma de envio
    - `pathParams` object — Conjunto de pares chave-valor em que cada chave corresponde ao nome de um campo esperado pelo template WhatsApp
    - `template` string — Nome do template cadastrado na plataforma de envio

## Response `201`

Conta criada com sucesso

- CreateAccountResponse
  - `biometricProvider` 'idwall' | 'serpro' — Provedor biométrico
  - `cloudConfig` CloudConfigPayload
    - `access_key` string
    - `container` string
    - `provider` string
    - `region` string
    - `secret_key` string
    - `session_token` string
  - `color` string — Cor em hexadecimal
  - `companyId` string — Identificador da empresa no Nuvidio Call para redirecionamento em transbordo
  - `contractedIntelligences` ContractedIntelligence[] — Lista de inteligências contratadas
  - `createdAt` string — Data e hora de criação
  - `id` string — Identificador da conta
  - `logo` string — Logo da conta
  - `name` string — Nome da conta
  - `organizationId` string — Identificador da organização
  - `slug` string — Identificador amigável da conta
  - `styleId` string — Identificador do template de estilo
  - `transcriptionProvider` 'bot_runner' — Provedor de transcrição
  - `updatedAt` string — Data e hora da última modificação
  - `videoProvider` 'daily' — Provedor de vídeo
  - `whatsappConfig` WhatsAppConfigPayload
    - `apiKey` string — Chave de API da plataforma de envio
    - `apiSecret` string — Segredo da API da plataforma de envio
    - `pathParams` object — Conjunto de pares chave-valor em que cada chave corresponde ao nome de um campo esperado pelo template WhatsApp
    - `template` string — Nome do template cadastrado na plataforma de envio

## Other responses

- `400` — Erro de validação do corpo
- `422` — JSON inválido ou ilegível
- `500` — Erro inesperado ao criar a conta

---

[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/revisions/a262554413c2/schema)