Untag Leads

Using this API, you can untag a lead or remove a tag associated with a lead. All you need to provide is the tag name, and email address of  the lead whom you want to untag.

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/deassociate

API Limit

  • Duration: 5 mins
  • Number of Calls: 500
  • Lock Period: 30 mins

You can send 500 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

ParameterData typeDescription
tagName*StringName of the tag
lead_email*StringProvide email address of the respective contact.

* - Mandatory parameters

Possible error cases

Error codeDescription
993Specified lead not found
6613Specified tag not found.
6615Error 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/deassociate?lead_email=patricia@zylker.com&tagName=interested

Sample Response

Copied{
    "code": "0",
    "message": "Tag deassociated successfully",
    "version": "1",
    "uri": "/api/v1/tag/deassociate",
    "status": "success"
}