Zoho CRM: Workflow Rules Get Workflow Rule By ID

Get one Zoho CRM workflow rule by its ID, with its trigger, criteria and actions.

Tool ID: zoho_crm_workflow_rules_get_workflow_rule_by_id

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_workflow_rules_get_workflow_rule_by_id',
  {
    "id": "id_123"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute zoho_crm_workflow_rules_get_workflow_rule_by_id --input '{
  "id": "id_123"
}' --json

Example response

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

Input reference

To retrieve the details of a specific Workflow rule in your Zoho CRM account.

Name	Type	Required	Default	Details
`payload.id`	`string`	Yes	—	Single ID of a workflow rule. Format: `string`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Single Workflow Rule Response Body.
`result.data.workflow_rules`	`array`	Yes	—	Field: workflow_rules Maximum items: 10.
`result.data.workflow_rules[].created_time`	`string`	Yes	—	Field: created_time Format: `date-time`. Maximum length: 255.
`result.data.workflow_rules[].execute_when`	`record`	Yes	—	—
`result.data.workflow_rules[].editable`	`boolean`	Yes	—	Field: editable
`result.data.workflow_rules[].module`	`object`	Yes	—	Specify the module/field to which the workflow rule applies
`result.data.workflow_rules[].module.api_name`	`string`	No	—	Specify the api name of the module/field Maximum length: 100.
`result.data.workflow_rules[].module.id`	`string`	No	—	Specify the unique id of the module/field Maximum length: 20.
`result.data.workflow_rules[].deprecated`	`boolean`	No	—	Field: deprecated
`result.data.workflow_rules[].deletable`	`boolean`	Yes	—	Field: deletable
`result.data.workflow_rules[].description`	`string \| null`	Yes	—	Field: description Maximum length: 255.
`result.data.workflow_rules[].source`	`string`	Yes	—	Field: source Maximum length: 255.
`result.data.workflow_rules[].created_by`	`object`	Yes	—	Field: created_by
`result.data.workflow_rules[].created_by.name`	`string`	No	—	Name of the user who created the rule. Format: `string`.
`result.data.workflow_rules[].created_by.id`	`string`	No	—	Id of the user who created the rule. Format: `string`.
`result.data.workflow_rules[].last_executed_time`	`string \| null`	Yes	—	Field: last_executed_time Format: `date-time`.
`result.data.workflow_rules[].modified_time`	`string \| null`	Yes	—	Time Object Format: `date-time`. Maximum length: 255.
`result.data.workflow_rules[].name`	`string`	Yes	—	Field: name Maximum length: 255.
`result.data.workflow_rules[].modified_by`	`object`	Yes	—	Field: created_by
`result.data.workflow_rules[].modified_by.name`	`string`	No	—	Name of the user who created the rule. Format: `string`.
`result.data.workflow_rules[].modified_by.id`	`string`	No	—	Id of the user who created the rule. Format: `string`.
`result.data.workflow_rules[].lock`	`object`	Yes	—	Details the lock status of the workflow, including information about who locked it, the message associated with the lock, and whether it is currently locked.
`result.data.workflow_rules[].lock.locked_by`	`record`	No	—	Field: locked_by
`result.data.workflow_rules[].lock.message`	`string \| null`	No	—	A note or label to indicate the reason or context for locking the rule. Format: `string`.
`result.data.workflow_rules[].lock.status`	`boolean`	No	—	Field: status
`result.data.workflow_rules[].id`	`string`	Yes	—	Field: id Maximum length: 20.
`result.data.workflow_rules[].category`	`string`	No	—	Field: category Maximum length: 255.
`result.data.workflow_rules[].conditions`	`array`	No	—	An array of condition objects that define the criteria for executing the actions. (Required) Maximum items: 5.
`result.data.workflow_rules[].conditions[].sequence_number`	`integer`	Yes	—	Represents the execution order for the criteria. The index starts from 1. (Required) Format: `int32`.
`result.data.workflow_rules[].conditions[].instant_actions`	`object`	Yes	—	The list of Instant Actions to execute immediately when condition is met. Maximum 5 instant action
`result.data.workflow_rules[].conditions[].instant_actions.actions`	`array`	Yes	—	An array of action objects (Required) Maximum items: 50.
`result.data.workflow_rules[].conditions[].scheduled_actions`	`array \| null`	No	—	The list of Scheduled Actions to execute when condition is met Maximum items: 5.
`result.data.workflow_rules[].conditions[].scheduled_actions[].execute_after`	`object`	No	—	Specify when the scheduled actions should be executed
`result.data.workflow_rules[].conditions[].scheduled_actions[].execute_after.period`	`"business_hours" \| "hours" \| "business_days" \| "days" \| "minutes" \| "weeks" \| "months" \| "years"`	Yes	—	Specify the type of time interval (Required) Allowed: `business_hours`, `hours`, `business_days`, `days`, `minutes`, `weeks`, `months`, `years`.
`result.data.workflow_rules[].conditions[].scheduled_actions[].execute_after.unit`	`integer`	Yes	—	Specify the value of the time interval (Required) Format: `int32`.
`result.data.workflow_rules[].conditions[].scheduled_actions[].actions`	`array`	Yes	—	An array of action objects Maximum items: 10.
`result.data.workflow_rules[].conditions[].scheduled_actions[].id`	`string`	No	—	Unique Id of the scheduled action Maximum length: 20.
`result.data.workflow_rules[].conditions[].criteria_details`	`object`	Yes	—	Specify the conditions a record must meet for the workflow rule to trigger. Set this to null to apply the rule to all records in the module.
`result.data.workflow_rules[].conditions[].criteria_details.criteria`	`record`	No	—	The root criteria object. Can be a group or a single leaf condition
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria`	`object`	No	—	Specify conditions based on a related module’s records. The relational_criteria key is supported only in triggers where the workflow can be evaluated against records in a related module. Examples include Email triggers, Call triggers, social media triggers, Notes triggers, and Appointment module triggers. It is not applicable for purely time-based triggers or triggers restricted to the same module without related-record checks.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria`	`object \| null`	No	—	Specifies which records the rule should apply to. Set this to null to apply the rule to all records.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.comparator`	`string`	Yes	—	Comparison operator. Maximum length: 50.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.field`	`object`	Yes	—	Specify the module/field to which the workflow rule applies
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.field.api_name`	`string`	No	—	Specify the api name of the module/field Maximum length: 100.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.field.id`	`string`	No	—	Specify the unique id of the module/field Maximum length: 20.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.value`	`string`	Yes	—	The value to compare with. Use ${EMPTY} to check for empty fields. Maximum length: 50.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.type`	`string`	No	—	Value Type Maximum length: 50.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.group_operator`	`string`	Yes	—	Logical operator for combining conditions (e.g., and/or). Maximum length: 3.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.criteria.group`	`array`	Yes	—	List of nested conditions or groups. Maximum items: 25.
`result.data.workflow_rules[].conditions[].criteria_details.relational_criteria.module_selection`	`"all" \| "specific" \| "unknown" \| null`	No	—	Specify the details of the related record to be evaluated. Allowed: `all`, `specific`, `unknown`, `null`.

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe zoho_crm_workflow_rules_get_workflow_rule_by_id --json.

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