> ## Documentation Index
> Fetch the complete documentation index at: https://legitimuz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 1. Criar integração

> Crie a integração em sandbox que vai reunir os fluxos, as chaves e os webhooks do seu produto.

Ao final deste passo você tem uma integração em sandbox — o container de tudo que vem depois:
fluxos, domínios autorizados, chaves de API e webhooks pertencem a ela.

<Info>
  A plataforma está em rollout com parceiros. Cada passo deste caminho declara o que já funciona e
  o que ainda não foi liberado; o passo [7. Testar](/setup/test) depende da emissão de verificações
  pela API, que ainda não está disponível.
</Info>

## Pré-requisitos

* Acesso ao dashboard da Legitimuz com permissão para criar integração. Se o menu **Integrações**
  não aparece para você, o seu papel não tem essa capacidade — veja
  [permissões](/dashboard/permissions).

## O que é uma integração

Uma integração é um canal ou produto seu: um app iOS, um site de cadastro, um ambiente de
homologação. Cada uma carrega as próprias chaves e os próprios webhooks, então o vazamento de uma
credencial não alcança as outras, e um ambiente de teste nunca dispara webhook em produção.

O **ambiente** é escolhido na criação e não muda depois:

| Ambiente     | Para quê                                     |
| ------------ | -------------------------------------------- |
| **Sandbox**  | testar a integração. Não atende titular real |
| **Produção** | verificações de titular real                 |

Comece pela sandbox. Nenhum dado real é processado enquanto você estiver nela.

## Crie a integração

<Steps>
  <Step title="Abra Integrações">
    No menu lateral do dashboard, abra **Integrações**.
  </Step>

  <Step title="Preencha o formulário">
    Clique em **Criar integração** e preencha:

    * **Nome da integração** — algo que diga onde ela roda, como `App iOS` ou `Homologação`. Dá
      para renomear depois.
    * **Ambiente** — escolha **Sandbox**.

    <Frame>
      <img src="https://mintcdn.com/legitimuz/7lQQUiJ9e5iQbgeZ/images/placeholder.svg?fit=max&auto=format&n=7lQQUiJ9e5iQbgeZ&q=85&s=bf49073b1ebddfe05f2241d098d54068" alt="Formulário Criar integração aberto no dashboard, com o campo Nome da integração preenchido e Ambiente em Sandbox" width="1600" height="900" data-path="images/placeholder.svg" />
    </Frame>
  </Step>

  <Step title="Confirme">
    Clique em **Criar integração**. Ela passa a aparecer na listagem.
  </Step>
</Steps>

## Confira que funcionou

A integração aparece na tabela de **Integrações** com a coluna **Ambiente** em `Sandbox` e a coluna
**Fluxo padrão** vazia — é o próximo passo que preenche essa coluna.

## Próximo passo

<Card title="2. Fluxos" icon="workflow" href="/setup/flows">
  Escolha um template pronto ou monte o grafo do fluxo no builder.
</Card>