younifyd
Menu

Change owner of records

Change owner of records

POST/{module}/actions/change_owner

Use it in a workflow

  1. Add a step and choose the Zoho CRM connector.
  2. Pick the Change owner of records action (under Records).
  3. Fill in the fields below, then reference the result from later steps as {{changeOwnerOfRecords.response.data}}.

Request

Path parameters

modulestringrequired

Specify the API name of the module.

Query parameters

idsstring

Deprecated — use the `ids` array in the request body instead.

notifyboolean

Deprecated — use the `notify` field in the request body instead.

owner_idstring

Deprecated — use the `owner.id` field in the request body instead.

related_modulesstring

Deprecated — use the `related_modules` array in the request body instead.

Request body

Enter the body as JSON in the step's Body field.

idsarray<string>required

Specify the IDs of the records for which you want to change the owner.

ownerobjectrequired

Specify the details of the new owner for the records.

idstringrequired

Specify the user ID of the new owner.

notifyboolean | null

Specify whether to notify the new owner via email when the records are assigned.\nPossible values:\n**true** - The new owner is notified via email.\n**false** - The new owner is not notified via email.

related_modulesarray<object>

Specify the related modules for which you want to transfer record ownership along with the main record.

api_namestring

Specify the API name of the related module for which the records are transferred.\nPossible values:\n**Tasks**\n**Events**\n**Calls**\n**Contacts**\n**Deals**

One ofTasksEventsCallsContactsDeals

idstring

Specify the record ID of the related module record to transfer to the new owner.

json
{
  "ids": [
    "string"
  ],
  "owner": {
    "id": "string"
  },
  "notify": false,
  "related_modules": [
    {
      "api_name": "Tasks",
      "id": "string"
    }
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{changeOwnerOfRecords.response.data.<field>}}.

dataarray<object>

Data containing the result of the owner change operation

codestringrequired

Response code indicating success

One ofSUCCESS

detailsobjectrequired1 fields

Details of the updated record

messagestringrequired

Success message

statusstringrequired

Status of the operation

One ofsuccess

json
{
  "data": [
    {
      "code": "SUCCESS",
      "details": {
        "id": "string"
      },
      "message": "string",
      "status": "success"
    }
  ]
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.