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

API Limit

Duration: 5 mins
Number of Calls: 100
Lock Period: 30 mins

You can send 100 API calls per 5 minutes. If you hit this limit, you can't use this API for the next 30 minutes due to security reasons, but you can still use other APIs if their lock period hasn’t been reached.

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"
}