Skip to content

Tags

Use these tools to create and manage the manual tags available in a KlickTipp account. Tags provide a flexible way to organize contacts, describe their interests or status, and connect customer information with targeting and automation.

For example, you can create a new classification, update its name or description, find existing tags, or remove definitions that are no longer needed. Assigning or removing tags on individual contacts belongs to the Contact Tagging group, while further tag-management actions may be added in the future.

Create Manual Tag

Tool name: create-manual-tag

Creates a manual tag in KlickTipp, one that is assigned deliberately rather than by KlickTipp itself. Creating a tag assigns it to nobody and changes no contact. Tags are never created as a side effect elsewhere, so a tag a contact should carry has to be created here first. The name has to be unique within the account. The description is what tells a later reader what the tag means.

Input schema

namestring, [ 1 .. 250 ] charactersrequired

Name of the tag, which has to be unique within the account and cannot be a number alone

descriptionnull or string, <= 2000 characters

What the tag stands for, so a person or a model reading it later knows when to assign it

Default:null
accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null
Input example
{ "name": "string", "description": null, "accountId": null }

Output schema

accountIdintegerrequired
idintegerrequired
namestringrequired
descriptionstringrequired
typestringrequired
isWritablebooleanrequired
multiValuebooleanrequired
editUrlstringrequired
usedByArray of stringsrequired
Output example
{ "accountId": 0, "id": 0, "name": "string", "description": "string", "type": "string", "isWritable": true, "multiValue": true, "editUrl": "string", "usedBy": [ "string" ] }