Skip to main content
GET
List contact tags
Find a tag by name, then pass its tagId to the tagIds filter when searching contacts. Each result includes the tag’s identifier (tagId) and name (value). Use the optional name filter to match the beginning of a tag name. Matching is case-sensitive; the filter accepts up to 256 characters. Rate limit: 120 requests/minute per endpoint and workgroup. Details.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Query Parameters

name
string

Optional case-sensitive tag name prefix. The value is trimmed and capped at 256 characters.

Required string length: 1 - 256
limit
integer
default:100

Maximum tags to return. Defaults to 100 and is capped at 500 to keep free discovery requests bounded.

Required range: 1 <= x <= 500

Response

Contact tags for the authenticated workgroup.

All contact tags in the authenticated workgroup that match the optional name prefix.

items
object[]
count
integer

Number of tags returned.