younifyd
Menu

Change a record's owner

Change a record's owner

POST/{module}/{record}/actions/change_owner

Use it in a workflow

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

Request

Path parameters

modulestringrequired

Specify the API name of the module.

recordstringrequired

Specify the ID of the record for which you want to change the owner.

Query parameters

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.

ownerobjectrequired

Specify the details of the new owner for the record.

idstringrequired

Specify the user ID of the new owner.

notifyboolean | null

Specify whether to notify the new owner via email when the record is 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
{
  "owner": {
    "id": "string"
  },
  "notify": false,
  "related_modules": [
    {
      "api_name": "Tasks",
      "id": "string"
    }
  ]
}

Response

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

dataarray<object>

Data containing the result of the owner change operation

codestringrequired

Represents the response code indicating the outcome of the request. Possible values: **SUCCESS** - The owner change operation completed successfully.

One ofSUCCESS

detailsobjectrequired1 fields

Represents the details of the record for which the owner change was applied.

messagestringrequired

Represents a brief message confirming the outcome of the owner change operation.

statusstringrequired

Represents the status of the operation. Possible values: **success** - The owner change operation completed without errors.

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.