Criar etiqueta
POST
/accounts/tagsCria uma etiqueta na conta e devolve o ID dela. O nome vai em formulário (application/x-www-form-urlencoded), não em JSON.
Requisição
curl -X POST "https://app.nextagsai.com.br/api/accounts/tags" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
--data-urlencode 'name=cliente-vip'
const resposta = await fetch('https://app.nextagsai.com.br/api/accounts/tags', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
},
body: new URLSearchParams({
name: 'cliente-vip',
}),
});
const dados = await resposta.json();
console.log(resposta.status, dados);
import os
import requests
resposta = requests.post(
"https://app.nextagsai.com.br/api/accounts/tags",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
data={
"name": "cliente-vip",
},
timeout=30,
)
print(resposta.status_code, resposta.json())
<?php
$ch = curl_init('https://app.nextagsai.com.br/api/accounts/tags');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
],
CURLOPT_POSTFIELDS => http_build_query([
'name' => 'cliente-vip',
]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);
Autenticação
Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.
Corpo da requisição
FormulárioContent-Type: application/x-www-form-urlencoded
namestringobrigatórioO nome da etiqueta.
Exemplo: cliente-vip
Respostas
200Sucesso
A etiqueta criada.
idintegerO ID da etiqueta nova.
401Chave inválida
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Visão geral da API
Guia que usa este endpointContatos, fluxos e outros identificadores
Guia que usa este endpointEtiquetar contatos e preencher campos
Guia que usa este endpointUsar a API no Make, n8n e Zapier
Guia que usa este endpointListar etiquetas
GET /accounts/tagsConsultar etiqueta
GET /accounts/tags/{tag_id}Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.