Pular para o conteúdo principal
POST
Adicionar ou remover tags de clientes

Autorizações

Authorization
string
header
obrigatório

API key criada nas configurações da organização.

Cabeçalhos

Idempotency-Key
string

Chave única da operação. Repetir a mesma chave com o mesmo corpo devolve a resposta original em vez de executar de novo.

Corpo

application/json
action
enum<string>
obrigatório

add adiciona as tags; remove tira. As outras tags dos clientes continuam.

Opções disponíveis:
add,
remove
tag_ids
string[]
obrigatório

IDs das tags (tag_...), até 20.

Required array length: 1 - 20 elements
Pattern: ^tag_[A-Za-z0-9_-]+$
customer_ids
string[]
obrigatório

IDs dos clientes (cus_...), até 500 por chamada.

Required array length: 1 - 500 elements
Pattern: ^cus_[A-Za-z0-9_-]+$
operation_id
string

Identificador único opcional desta chamada, como um UUID. Repita o mesmo valor só para tentar de novo a mesma chamada: a nova tentativa devolve o primeiro resultado em vez de criar de novo. O mesmo valor com outro conteúdo é recusado com 409.

Required string length: 8 - 128

Resposta

Tags dos clientes atualizadas.

object
string
obrigatório
Allowed value: "customer_tags"
action
enum<string>
obrigatório
Opções disponíveis:
add,
remove
customers
integer
obrigatório
Intervalo obrigatório: x >= 0
tag_ids
string[]
obrigatório
Pattern: ^tag_[A-Za-z0-9_-]+$
changed
integer
obrigatório

Vínculos entre cliente e tag criados ou removidos.

Intervalo obrigatório: x >= 0