List contact tags
curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/tags \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/tags"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/tags' -Method GET -Headers $headers{
"items": [
{
"tagId": "<string>",
"value": "<string>"
}
],
"count": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}Contacts
List contact tags
Find tags in your Jobin workgroup to use in contact searches.
GET
/
contacts
/
tags
List contact tags
curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/tags \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/tags"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/tags' -Method GET -Headers $headers{
"items": [
{
"tagId": "<string>",
"value": "<string>"
}
],
"count": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}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
Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.
Query Parameters
Optional case-sensitive tag name prefix. The value is trimmed and capped at 256 characters.
Required string length:
1 - 256Maximum tags to return. Defaults to 100 and is capped at 500 to keep free discovery requests bounded.
Required range:
1 <= x <= 500