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

List of parameters

Parameter

Data type

Description

tagName*

String

Name of the tag

lead_email*

String

Provide email address of the respective 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/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"
}