Zoho CRM: Record Upsert Records

Create Zoho CRM records or update existing ones that match on duplicate check fields, such as email.

Tool ID: zoho_crm_record_upsert_records

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'zoho_crm_record_upsert_records',
  {
    "module": "example",
    "data": [
      {
        "id": "id_123"
      }
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute zoho_crm_record_upsert_records --input '{
  "module": "example",
  "data": [
    {
      "id": "id_123"
    }
  ]
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe zoho_crm_record_upsert_records --json for the complete live contract.

Input reference

Request body schema for upsert operations, allowing creation or update of records based on duplicate fields.

Name	Type	Required	Default	Details
`payload.module`	`string`	Yes	—	Specifies the module name Maximum length: 100.
`payload.data`	`array`	Yes	—	List of records to be created or updated using the upsert operation. Maximum items: 100.
`payload.trigger`	`array`	No	—	List of automation triggers to be executed during the upsert operation. Maximum items: 10.
`payload.duplicate_check_fields`	`array`	No	—	Defines the ordered list of fields used to detect duplicate records during upsert. Maximum items: 10.
`payload.wf_trigger`	`string`	No	—	Workflow trigger identifier to be executed as part of the upsert operation.
`payload.lar_id`	`string`	No	—	Layout assignment rule identifier used to determine record layout during upsert.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Standard success response schema for single or bulk record operations.
`result.data.data`	`array`	Yes	—	List of successfully processed records with detailed metadata. Maximum items: 100.
`result.data.data[].code`	`"SUCCESS"`	Yes	—	Machine-readable code indicating a successful operation. Allowed: `SUCCESS`.
`result.data.data[].message`	`string`	Yes	—	Human-readable success message describing the operation outcome. Maximum length: 1024.
`result.data.data[].status`	`"success"`	Yes	—	Overall execution status of the operation. Allowed: `success`.
`result.data.data[].details`	`object`	Yes	—	Detailed metadata about the processed record.
`result.data.data[].details.id`	`string`	Yes	—	Unique identifier of the record. Format: `int64`.
`result.data.data[].details.Modified_Time`	`string`	Yes	—	Timestamp indicating when the record was last modified. Format: `date-time`.
`result.data.data[].details.Created_Time`	`string`	Yes	—	Timestamp indicating when the record was created. Format: `date-time`.
`result.data.data[].details.Created_By`	`object`	Yes	—	User who originally created the record.
`result.data.data[].details.Created_By.name`	`string`	Yes	—	Display name of the creating user. Maximum length: 100.
`result.data.data[].details.Created_By.id`	`string`	Yes	—	Unique identifier of the creating user. Format: `int64`.
`result.data.data[].details.Modified_By`	`object`	Yes	—	User who last modified the record.
`result.data.data[].details.Modified_By.name`	`string`	Yes	—	Display name of the modifying user. Maximum length: 100.
`result.data.data[].details.Modified_By.id`	`string`	Yes	—	Unique identifier of the modifying user. Format: `int64`.
`result.data.data[].details.$approval_state`	`string`	Yes	—	Approval state of the record in the approval workflow. Maximum length: 1024.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation