Skip to main content
POST
Create a contact tag
Create a reusable tag by sending its name and the Instagram account that owns it. Your API key needs the contacts:write scope and access to account_id.

Request body

Send exactly these fields:
  • account_id: the UUID of the Instagram account.
  • name: the tag name.
levios trims name and collapses consecutive whitespace to one space. The normalized name must contain 1 through 50 characters. The raw input can contain at most 200 characters, and the normalized result cannot contain control characters.

Read the result

The response contains tag and created. created is true when the API created a new catalog entry. If the normalized name already exists, the API returns that tag with created: false. This makes the operation idempotent for the same account and normalized name. An account can have up to 5,000 catalog tags.
If the API returns api_contact_tag_response_unavailable with committed: true and retryable: false, the tag changed but the response could not be verified. Do not retry automatically. List the account’s tags before deciding whether to send another request.

Authorizations

Authorization
string
header
required

Levios API key sent as a Bearer token.

Body

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

Response

Successful response.