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

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