# API da NexTags

> Gere a chave de API da conta e use a API da NexTags para criar contatos, mandar fluxos, aplicar etiquetas e preencher campos a partir do seu sistema.

Endereço: https://help.nextags.com.br/integracoes/api/
Tipo: Integração

Atualizado em: 25/10/2026

A API da NexTags deixa o seu sistema, ou um integrador como o Make, o n8n e o Zapier, trabalhar com a conta: criar e achar contatos, mandar fluxos e mensagens, aplicar etiquetas, preencher campos e mover oportunidades nos pipelines. Cada chamada leva a chave de API da conta no cabeçalho `X-ACCESS-TOKEN`. A referência completa, endpoint por endpoint, fica na central de desenvolvedores.

## O que dá para fazer

- Criar contatos e achar um contato pelo e-mail ou pelo telefone. Veja [Criar ou atualizar um contato](https://docs.nextags.com.br/guias/criar-ou-atualizar-contato/).
- Mandar um fluxo, um texto ou um arquivo para um contato. Veja [Enviar um fluxo para um contato](https://docs.nextags.com.br/guias/enviar-fluxo/).
- Aplicar etiquetas e preencher campos. Veja [Etiquetar contatos e preencher campos](https://docs.nextags.com.br/guias/etiquetas-e-campos/).
- Criar e mover oportunidades nos pipelines. Veja [Criar e mover oportunidades no pipeline](https://docs.nextags.com.br/guias/oportunidades-no-pipeline/).

## Como conectar

### Passo 1: Gere a chave

No pé do menu, clique em **Configurações** e abra a aba **Integrações** (1). Clique em **Chave de API do NexTags** (2), o primeiro cartão, e depois em **Gerar** (3).

![Aba Integrações com o cartão Chave de API do NexTags aberto, o campo da chave vazio, o botão Gerar e o texto que fala do uso da chave no Zapier, no Integromat e no Pabbly, com o link Saber Mais.](https://help.nextags.com.br/_img/configuracoes/api-gerar.webp)
*1. Integrações. 2. Chave de API do NexTags. 3. Gerar. 4. Saber Mais.*

1. A aba **Integrações**.
2. O cartão **Chave de API do NexTags**.
3. **Gerar**: cria a chave da conta.
4. **Saber Mais**: abre a documentação da API.

### Passo 2: Copie a chave

A chave aparece no campo, e o cartão ganha o selo **Ativa**. Clique no campo, selecione a chave inteira e copie.

![Cartão Chave de API do NexTags com uma chave de exemplo no campo, o selo Ativa e o botão Excluir.](https://help.nextags.com.br/_img/configuracoes/api-chave.webp)
*1. A chave (aqui, uma de exemplo). 2. Excluir.*

1. A chave da conta.
2. **Excluir**: apaga a chave na hora, sem perguntar.

> **Guarde a chave:**
> Quem tem a chave acessa a conta pela API. Não publique a chave nem mande por mensagem aberta.

### Passo 3: Faça a primeira chamada

O endereço base da API é `https://app.nextagsai.com.br/api`. Para conferir a chave, consulte os dados da conta, com a chave no cabeçalho `X-ACCESS-TOKEN`:

```bash
curl https://app.nextagsai.com.br/api/accounts/me \
  -H "X-ACCESS-TOKEN: SUA_CHAVE"
```

A resposta traz o nome e os dados da conta. Veja [Sua primeira requisição](https://docs.nextags.com.br/comecar/primeira-requisicao/) e [Consultar a conta](https://docs.nextags.com.br/referencia/conta/consultar-a-conta/).

O passo a passo completo da chave está em [Gerar a chave de API](https://help.nextags.com.br/tutoriais/configuracoes/chave-de-api/). Para começar na central de desenvolvedores, veja [Visão geral da API](https://docs.nextags.com.br/comecar/visao-geral/) e [Autenticação com a chave de API](https://docs.nextags.com.br/comecar/autenticacao/).

## Se não funcionou

### A API diz que a chave é inválida

Copie a chave inteira, sem espaços no começo ou no fim, e mande no cabeçalho `X-ACCESS-TOKEN`. Se a chave foi excluída e gerada de novo, use a nova.

### Não vejo a aba Integrações

Só quem é **Super Administrador** abre as **Configurações**. Peça a um Super Administrador para gerar a chave. Veja [Onde encontro a chave de API?](https://help.nextags.com.br/perguntas/integracoes/onde-fica-a-chave-de-api/).

### Preciso de algo que a API não faz

Combine a API com os webhooks: o webhook de entrada recebe dados e inicia fluxos, e o webhook de saída avisa o seu sistema dos eventos da conta. Veja [Webhooks](https://help.nextags.com.br/integracoes/webhooks/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Quero ligar o meu sistema à NexTags pela API. Leia esta página: https://help.nextags.com.br/integracoes/api.md

O meu sistema: [descreva, por exemplo: uma loja que precisa criar o contato e mandar um fluxo de boas-vindas a cada venda]. Escreva os exemplos de chamada, com a chave no cabeçalho X-ACCESS-TOKEN, sem que eu precise colar a minha chave aqui.
```