Assign lead tags
Using this API, you can assign tags to lead. You can assign tags only to active lead. All you need to provide is the tag name, and email address of a lead to whom you want to assign the corresponding tag.
Scope required
ZohoMarketingAutomation.lead.UPDATE
Other alternative scopes
ZohoMarketingAutomation.lead.CREATE-UPDATE (CREATE + UPDATE)
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/associate
List of parameters
Parameter | Data type | Description |
tagName* | String | Name of the tag |
lead_email* | String | Provide email address of your contact. |
* - Mandatory parameters
Possible error cases
Error code | Description |
993 | Specified lead not found |
6613 | Specified tag not found. |
6615 | Error in displaying results. Please try later |
If your error code is not listed above, click here.
Sample request
Copiedhttps://marketingautomation.zoho.com/api/v1/tag/associate?lead_email=patricia@zylker.com&tagName=interested
Sample response
Copied{
"code": "0",
"message": "Tag associated successfully",
"version": "1",
"uri": "/api/v1/tag/associate",
"status": "success"
}