List tags

GET

/api/v3/contacts/tags

const url = 'https://api.tryletterhead.com/api/v3/contacts/tags?api=true&sort=name&direction=asc';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/contacts/tags?api=true&sort=name&direction=asc' \
  --header 'Authorization: Bearer <token>'

Returns a paginated, searchable list of your company’s tags, each with its audience-member count.

Query parameters

page (default 1), limit (default 500, max 500).
search — filter by tag name.
sort — name (default) or audienceMembers.
direction — asc (default) or desc.

Authorizations

bearerAuth

Parameters

Query Parameters

api

required

boolean

Required. Set to true.

page

integer

limit

integer

search

string

sort

string

Allowed values: name audienceMembers

direction

string

Allowed values: asc desc

Responses

200

200 OK

application/json

object

items

Array<object>

object

integer

name

string

color

string

audienceMembers

integer

createdAt

string

updatedAt

string

message

string

total

Total matching tags, for pagination — pair with page/limit.

integer

Example

{
  "items": [
    {
      "id": 7,
      "name": "engaged-readers",
      "color": "#4287f5",
      "audienceMembers": 1204,
      "createdAt": "2026-04-30T15:01:21+00:00",
      "updatedAt": "2026-08-12T09:14:02+00:00"
    }
  ],
  "message": "Tags retrieved.",
  "total": 1
}

Still can’t find what you need? Contact support.