> ## Documentation Index
> Fetch the complete documentation index at: https://developers.sults.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Crie o token da API v1 do SULTS

> O passo a passo para gerar o token da API v1 do SULTS na Gestão de Tokens v1, com prints da plataforma

<span className="badge-v1">API v1</span>

O token da v1 nasce dentro da plataforma, criado por um usuário administrador. Sem ele nenhuma chamada é aceita.

## Gere o token

<Steps>
  <Step title="Entre na plataforma">
    Acesse `https://suamarca.sults.com.br` com um usuário **administrador**.
  </Step>

  <Step title="Abra Segurança">
    No painel inicial, clique no ícone **Segurança**.
  </Step>

  <Step title="Vá em API">
    No menu lateral esquerdo, clique em **API**.
  </Step>

  <Step title="Abra a Gestão de Tokens v1">
    A tela mostra as duas gestões lado a lado. Abra a **v1** e clique em **Criar Token**.
  </Step>

  <Step title="Nomeie e copie">
    Dê ao token o nome do sistema que vai usá-lo, por exemplo `ERP Financeiro`. Copie o código gerado e guarde em local seguro.
  </Step>
</Steps>

<Frame caption="Segurança > API: as duas gestões de token lado a lado">
  <img src="https://mintcdn.com/sults/-V7x2Uh2OwoLqSIk/images/seguranca-api.png?fit=max&auto=format&n=-V7x2Uh2OwoLqSIk&q=85&s=a0d15fd5326846bb357c070a57c66755" alt="Tela de Segurança e API no SULTS, com os cards de Gestão de Tokens v1 e v2" width="1916" height="1026" data-path="images/seguranca-api.png" />
</Frame>

Prefere vídeo? O passo a passo gravado também está na [Central de Ajuda](https://ajuda.sults.com.br/sults/como-gerar-token-de-integracao/).

<Frame>
  <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/8zTfq-YdBjQ" title="SULTS | Como gerar Token" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

## Use a gestão certa

<Warning>
  Os tokens **não são intercambiáveis**. Um token criado na Gestão de Tokens v2 recebe `401` nos endpoints da v1. Se a chamada falhou logo depois de você criar um token novo, confira em qual gestão ele nasceu.
</Warning>

Vai integrar o módulo de Compras pela nova geração? O token daquela versão se cria em outro lugar, e o caminho está em [criar token na v2](/v2/criar-token).

## Um token por integração

Crie um token para cada sistema que fala com o SULTS. Assim você revoga um acesso sem derrubar os outros, e o Log de Eventos na mesma tela de API mostra a origem de cada chamada.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Comece em 5 minutos" icon="rocket" href="/v1/quickstart">
    Use o token recém-criado na sua primeira chamada.
  </Card>

  <Card title="Autenticação" icon="key" href="/v1/autenticacao">
    Como enviar o token e guardá-lo com segurança em produção.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.