Saltar para o conteúdo principal
POST
cURL
Token e permissões: na Salez, acesse Configurações > Integrações Privadas para gerar ou gerenciar o token, conforme seu nível de acesso. Esta operação exige o escopo contacts.write. Envie Authorization: Bearer <token> e Version: v3. Veja a visão geral de Contatos.

Autorizações

Authorization
string
header
obrigatório

Use um token autorizado da subconta. Gere ou gerencie a integração em Configurações > Integrações Privadas na Salez, conforme as permissões do usuário. Informe o token no formato Bearer.

Cabeçalhos

Version
string
obrigatório

Versão obrigatória da API: v3.

Parâmetros de caminho

type
enum<string>
obrigatório

Tipo da operação: adicionar ou remover etiquetas.

Opções disponíveis:
add,
remove
Exemplo:

"add"

Corpo

application/json
contacts
string[]
obrigatório

IDs de contatos. Entre 1 e 500 por requisição.

Required array length: 1 - 500 elements
Exemplo:
tags
string[]
obrigatório

Etiquetas. Máximo de 50; somente pode ficar vazio se removeAllTags=true com tipo remove.

Maximum array length: 50
Exemplo:
locationId
string
obrigatório

Identificador da subconta.

Exemplo:

"ve9EPM428h8vShlRW1KT"

removeAllTags
boolean

Se true e operação remove, remove todas as etiquetas.

Exemplo:

false

Resposta

Resposta de sucesso.

succeeded
boolean
obrigatório

Indica se a operação foi concluída.

Exemplo:

true

errorCount
integer
obrigatório

Número de erros no processamento.

Exemplo:

0

responses
string[]
obrigatório

Retornos individuais do processamento.

Exemplo:
Última modificação em 20 de novembro de 2026