Get All Lead Tags

Using this API, you can get the list of lead tags. This API will list all the lead tags created under your organization.

Scope required

ZohoMarketingAutomation.lead.READ

Other alternative scopes

ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)

Header:

Authorization: Zoho-oauthtoken <access_token>

Request type:

Request URL

https://marketingautomation.zoho.com/api/v1/tag/getalltags

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.

Possible error cases

Error code	Description
992	No tags found to display

If your error code is not listed above, click here.

Sample request

Copiedhttps://marketingautomation.zoho.com/api/v1/tag/getalltags

Sample Response

Copied{
    "uri": "/api/v1/tag/getalltags",
    "version": "1",
    "requestdetails": "{}",
    "tags": [
        {
            "16492000023685218": {
                "tagowner": "patricia",
                "tag_created_time": "07 Feb 2019, 12:33 PM",
                "tag_name": "interested",
                "tag_color": "#48b9d1",
                "tag_desc": "list of interested leads",
                "tagged_contact_count": "64",
                "is_crm_tag": "false",
                "zuid": "xxxxxx"
            }
        },
        {
            "16492000023685001": {
                "tagowner": "patricia",
                "tag_created_time": "07 Feb 2019, 11:25 AM",
                "tag_name": "event",
                "tag_color": "#ff458a",
                "tag_desc": "prospects gathered in event",
                "tagged_contact_count": "171",
                "is_crm_tag": "false",
                "zuid": "xxxxxxx"
            }
        },
        {
            "16492000005417003": {
                "tagowner": "joel",
                "tag_created_time": "06 Dec 2018, 07:41 PM",
                "tag_name": "online",
                "tag_color": "#ff458a",
                "tag_desc": "leads signup online",
                "tagged_contact_count": "29",
                "is_crm_tag": "false",
                "zuid": "55216673"
            }
        },
        
                     ]
}