Skip to main content

GET /tags

List the tags of your account, ordered by label. Use these labels in the tags field when creating or updating a contact. Tags are matched by their exact label, so send each label exactly as this endpoint lists it, including any leading or trailing spaces and punctuation.

Optional Parameters​

ParameterTypeDescription
pageIntegerThe page of tags. Each page holds up to 100 tags. If not specified it will default to page 1.
searchstringReturns only the tags whose label contains this text. The match is case-insensitive (e.g. positiv matches Positive lead).

Example Request​

curl -X GET "https://api.callbell.eu/v1/tags?search=positiv" \
-H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
-H "Content-Type: application/json"

Response​

ParameterTypeDescription
tagsTag[]A list of tags.
meta.pagenumberThe current page.
meta.pagesnumberThe total number of pages for the same search.
meta.totalnumberThe total number of tags for the same search.

Example Response​

response.json
{
"tags": [
{
"label": "Positive lead",
"color": "green"
},
{
"label": "Positive review",
"color": "teal"
}
],
"meta": {
"page": 1,
"pages": 1,
"total": 2
}
}