Associate a Tag

This API is used for associating a tag to a contact.

Scope

  • ZohoCampaigns.contact.UPDATE

Request Type

  • GET

Request URL

  • https://campaigns.zoho.com/api/v1.1/tag/associate

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*StringEmail address of the contact to which the tag needs to be associated.

Possible Errors

Error CodeDescription
993No contact found.
9001Tag not found.
9002Error in displaying Results.

Sample JSON Request

Copiedhttps://campaigns.zoho.com/api/v1.1/tag/associate?resfmt=JSON&tagName=NewLetterTag&lead_email=patriciaboyle@zylker.com

Sample Response - Success

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

Sample Response - Failure

Copied{
    "code": "9001",
    "message": "Tag not found",
    "version": "1",
    "uri": "/api/v1/tag/associate",
    "status": "failure"
}