Skip to main content
POST
Create a contact tag
Crea una etiqueta reutilizable enviando su nombre y la cuenta de Instagram propietaria. Tu clave de API necesita el permiso contacts:write y acceso a account_id.

Cuerpo de la solicitud

Envía exactamente estos campos:
  • account_id: el UUID de la cuenta de Instagram.
  • name: el nombre de la etiqueta.
levios elimina los espacios de los extremos de name y reduce los espacios consecutivos a uno. El nombre normalizado debe tener entre 1 y 50 caracteres. La entrada sin procesar puede tener hasta 200 caracteres, y el resultado normalizado no puede contener caracteres de control.

Lee el resultado

La respuesta contiene tag y created. created es true cuando la API crea una entrada nueva en el catálogo. Si el nombre normalizado ya existe, la API devuelve esa etiqueta con created: false. Esto hace que la operación sea idempotente para la misma cuenta y el mismo nombre normalizado. Una cuenta puede tener hasta 5.000 etiquetas en el catálogo.
Si la API devuelve api_contact_tag_response_unavailable con committed: true y retryable: false, la etiqueta cambió, pero no se pudo verificar la respuesta. No reintentes la operación automáticamente. Lista las etiquetas de la cuenta antes de decidir si envías otra solicitud.

Autorizaciones

Authorization
string
header
requerido

Levios API key sent as a Bearer token.

Cuerpo

application/json
account_id
string<uuid>
requerido
name
any
requerido

Respuesta

Successful response.