Skip to Content
HelvetlyDocs
API referenceClients

List client tags

Needs a token with the read:clients scope (or write:clients). Authentication

Try in Playground sends a real request to app.helvetly.com with a token you paste. It stays in this browser tab only (session storage) and goes to no one else.

GET
/api/v1/clients/tags

Every tag used by a live client of the workspace with the number of clients carrying it, most used first. Tags are compared case-insensitively. Use it to pick a value for the tag filter of list_clients.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A personal API token, hvt_…, with scopes such as read:* or write:invoices

Response Body

OK

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://app.helvetly.com/api/v1/clients/tags'
Example Response
{  "data": [    {      "name": "string",      "count": 0    }  ]}