Skip to main content
POST
Create a contact tag
Crie uma tag reutilizável enviando o nome e a conta do Instagram proprietária. Sua chave de API precisa do escopo contacts:write e acesso a account_id.

Corpo da requisição

Envie exatamente estes campos:
  • account_id: o UUID da conta do Instagram.
  • name: o nome da tag.
A levios remove os espaços nas extremidades de name e reduz sequências de espaços em branco a um único espaço. O nome normalizado deve ter de 1 a 50 caracteres. A entrada bruta pode ter no máximo 200 caracteres, e o resultado normalizado não pode conter caracteres de controle.

Leia o resultado

A resposta contém tag e created. created será true quando a API criar uma nova entrada no catálogo. Se o nome normalizado já existir, a API retornará essa tag com created: false. Isso torna a operação idempotente para a mesma conta e o mesmo nome normalizado. Uma conta pode ter até 5.000 tags no catálogo.
Se a API retornar api_contact_tag_response_unavailable com committed: true e retryable: false, a tag mudou, mas não foi possível verificar a resposta. Não tente novamente de forma automática. Liste as tags da conta antes de decidir se deve enviar outra requisição.

Autorizações

Authorization
string
header
obrigatório

Levios API key sent as a Bearer token.

Corpo

application/json
account_id
string<uuid>
obrigatório
name
any
obrigatório

Resposta

Successful response.