Update Manual Tag

Tool name: update-manual-tag

Changes the name or the description of a manual tag in KlickTipp. Only manual tags can be changed: a tag KlickTipp puts on contacts itself takes its name from the newsletter, automation or form behind it and is refused. Renaming a tag does not change who carries it and does not break the campaigns and automations that use it, since those refer to its ID -- but the result lists them, because a rename shows up wherever the name is read. Everything else about the tag, including its auto-subscribe configuration and whether it is single value, stays as it is.

Input schema

tagIdinteger, >= 1required

ID of the manual tag to change

namenull or string, <= 250 characters

New name of the tag, which has to stay unique within the account; omit to keep the current one

Default:null

descriptionnull or string, <= 2000 characters

New description of what the tag stands for; omit to keep the current one

Default:null

accountIdnull or integer, >= 1

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

Default:null

Input example

{
  "tagId": 1,
  "name": null,
  "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"
  ]
}