Create lead tags
Lead tags are used to classify your leads into specific groups according to your requirements. Using this API, you can create lead tags and send campaigns to leads grouped under a specific tag.
Scope required
ZohoMarketingAutomation.lead.CREATE
Other alternative scopes
ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)
ZohoMarketingAutomation.lead.WRITE (CREATE + UPDATE + DELETE)
ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)
Header:
Authorization: Zoho-oauthtoken <access_token>
Content-Type: application/x-www-form-urlencoded
Request type:
Post
Request URL
https://marketingautomation.zoho.com/api/v1/tag/add
List of parameters
Parameter | Data type | Description |
tagName* | String | A name to your tag |
tagDesc | String | A description to the tag for your identification |
color | UTF-8 encoded | Encoded HTML Code of the desired color |
* - Mandatory parameters
Possible error cases
Error code | Description |
903 | Mandatory parameters are not found. |
6614 | Tag name already exists. |
6616 | Color code is invalid. |
If your error code is not listed above, click here.
Sample request
Copiedhttps://marketingautomation.zoho.com/api/v1/tag/add?tagName=interested&tagDesc=optin_leads&color=#0000FF
Sample Response
Copied{
"code": "0",
"TagInfoId": 16492000069308015,
"message": "Tag added successfully",
"version": "1",
"uri": "/api/v1/tag/add",
"status": "success"
}