Skip to main content
GET
List contact tags
This endpoint returns the reusable tag catalog for one Instagram account. Use the returned tag UUIDs when you add or remove tags from contacts. Automation configuration fields reference the normalized tag name, not the UUID.

Access

Your API key needs the contacts:write scope. The account_id query parameter must identify an Instagram account that the key can access. All contact-tag catalog and assignment operations use contacts:write, including this read operation.

Returned data

Each item contains:
  • id: the stable public UUID for the tag.
  • name: the normalized tag name.
Internal catalog IDs and usage counts are not exposed.

Pagination

Set limit to a value from 1 through 50. When next_cursor is not null, send it unchanged as cursor with the same account_id. Treat the cursor as opaque and stop when next_cursor is null.

Example request

Authorizations

Authorization
string
header
required

Levios API key sent as a Bearer token.

Query Parameters

account_id
string<uuid>
required
cursor
string
Required string length: 1 - 1024
limit
string

Response

Successful response.