Delink and Transfer Records

Purpose

To delink a user from the territory and assign the open records to the user of another territory.

Request Details

Request URL

To delink and transfer from all territories: {api-domain}/crm/{version}/users/{id}/territories/actions/transfer_and_delink
To delink and transfer from a specific territory: {api-domain}/crm/{version}/users/{id}/territories/{territory_id}/actions/transfer_and_delink

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.users.{operation_type}
(or)
scope=ZohoCRM.settings.territories.{operation_type}

Possible operation types

ALL - Full access to the record
UPDATE - Update records in the module

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v6/users/3652397000000281001/territories/actions/transfer_and_delink"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@updateuserterritory.json"
-X PUT

Input JSON Key

  • idstring, mandatory

    Represents the unique ID of the territory that you want to transfer the open records from.

  • transfer_to_userJSON object, mandatory

    Represents the unique ID of the new user that you want to transfer the open records to.

Sample Input

Copied{
    "transfer_and_delink": [
        {
            "id": "3652397000007612015",
            "transfer_to_user": {
                "id": "3652397000000186017"
            }
        }
    ]
}

Possible Errors

  • INVALID_DATAHTTP 400

    You have specified an invalid ID for territory or the user in the input.
    Resolution: Use the Get Territories API to get the unique IDs of the territories and the Get Users API for the user ID.

  • DEPENDENT_FIELD_MISSINGHTTP 400

    You have not specified the user's details you want to transfer the open records to.
    Resolution: You must specify the user's details in the "transfer_to_user" JSON object.

  • MANDATORY_NOT_FOUNDHTTP 400

    You have not specified the "transfer_and_delink" array in the input body.
    Resolution: "transfer_and_delink" is the root element of the input body for this API.

  • CANNOT_DELINKHTTP 400

    You have specified the territory's manager's ID in the input.
    Resolution: You cannot delink and transfer the records in a territory from the manager of that territory.

  • NOT_ALLOWEDHTTP 400

    Logged in users cannot update or delink their own territories.

  • NOT_ALLOWEDHTTP 400

    The user IDs of the new and existing territories are the same.

  • INVALID_DATAHTTP 400

    The user is invalid.
    Resolution: You can only delink and transfer records to an active CRM user.

  • INVALID_DATAHTTP 400

    Parent Territory cannt be associated with the user
    Resolution: You cannot delink and transfer records from the parent territory.

  • INVALID_DATAHTTP 400

    Territory ID is not linked with the user
    Resolution: The user is not a part of the territory you want to transfer records to.

Sample Response

Copied{
    "transfer_and_delink": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "3652397000007612015"
            },
            "message": "Territory is delinked from user successfully",
            "status": "success"
        }
    ]
}