Merge Tags


To merge two tags and move all associated records under the newly merged tag.

Request URL{tag_id}/actions/merge

tag_id - The unique ID of the tag

Request Method




Possible operation types
ALL - Full data access
CREATE - Create tag data

Possible Errors

HTTP StatusError CodeReasonResolution
404INVALID_URL_PATTERNThe URL you are trying to access in incorrect.Specify a valid request URL. Refer the Request URL section.
401OAUTH_SCOPE_MISMATCHYour client does not have ZohoCRM.settings.tags.CREATE scope.Create a new client with a valid scope. Refer the Scope section.

The user does not have permission to merge tags.

Contact your system administrator.


An unexpected and unhandled exception occurred in our server.

Reach out to our customer support team at


The HTTP request method type chosen is invalid.

Specify a valid request method. Refer the Request Method section.
400AUTHORIZATION_FAILEDThe user does not have the permission to merge tags.Contact your system administrator.
200INVALID_DATAThe input specified is incorrect.Specify valid input data in your request body.
200MANDATORY_NOT_FOUNDYou have not included one or more mandatory fields in your request body.Refer to Fields Metadata API to know the mandatory fields

Sample Request

Copiedcurl ",2000000030444/actions/merge" -
    X POST -
    H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    --data - raw '{
"data": [{
    "tags": [{
        "conflict_id": "2000000039012"

Sample Response

    "tags": [{
        "code": "SUCCESS",
        "message": "tags merged successfully",
        "status": "success",
        "details": {
            "created_by": {
                "id": "2000000030874",
                "name": "Medical"
            "created_time": "2017-03-24T11:08:23+05:30",
            "id": "2000000088041",
            "modified_by": {
                "id": "2000000030444",
                "name": "Pharma"
            "modified_time": "2017-03-24T11:08:23+05:30"