> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Zoho CRM: README
> GET /settings/automation/webhooks/{webhookId}. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.
GET /settings/automation/webhooks/\{webhookId}.
Tool ID: `zoho_crm_webhooks_get_webhook_by_id`
## Run this action
Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.
```ts theme={null}
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'zoho_crm_webhooks_get_webhook_by_id',
{
"webhookId": "webhook_123"
},
);
console.log(result.toolResponse.raw);
```
### CLI
```bash theme={null}
deepline tools execute zoho_crm_webhooks_get_webhook_by_id --input '{
"webhookId": "webhook_123"
}' --json
```
## Example response
The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.
```json theme={null}
{
"data": {
"webhooks": [
{
"module": {
"api_name": "Example",
"id": "id_123"
},
"url": "https://example.com",
"feature_type": "example",
"http_method": "example",
"name": "Example"
}
]
}
}
```
Use `deepline tools get zoho_crm_webhooks_get_webhook_by_id --json` for the latest machine-readable contract.
## Input reference
Retrieve the webhooks configured in your Zoho CRM account.
| Name | Type | Required | Default | Details |
| ------------------- | -------- | -------- | ------- | ------------------------------------------------------ |
| `payload.webhookId` | `string` | Yes | — | The ID of the webhook to retrieve. Maximum length: 20. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Retrieve the webhooks configured in your Zoho CRM account.",
"properties": {
"webhookId": {
"type": "string",
"description": "The ID of the webhook to retrieve.",
"maxLength": 20
}
},
"required": [
"webhookId"
],
"additionalProperties": false
}
```
## Output reference
Standard tool result payload.
| Name | Type | Required | Default | Details |
| ---------------------------------------------------------------------------- | ------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `result.data` | `object` | Yes | — | SUCCESS RESPONSE |
| `result.data.webhooks` | `array` | No | — | Field: webhooks Maximum items: 1. |
| `result.data.webhooks[].created_time` | `string` | No | — | Field: created\_time Maximum length: 255. |
| `result.data.webhooks[].headers` | `object` | No | — | Encapsulates headers for webhook requests including both module-specific and custom parameters, required for sending extra information. |
| `result.data.webhooks[].headers.custom_parameters` | `array` | No | — | These are static values that never change. They are always sent with the webhook call. Maximum items: 2. |
| `result.data.webhooks[].headers.custom_parameters[].name` | `string` | No | — | Specify a name to the custom header. Maximum length: 255. |
| `result.data.webhooks[].headers.custom_parameters[].value` | `string` | No | — | Specify a value to the custom header. Maximum length: 255. |
| `result.data.webhooks[].headers.module_parameters` | `array` | Yes | — | Headers let you send extra information along with the webhook request. For example, API keys, authentication tokens, or custom values that the external application needs. (Required) Maximum items: 3. |
| `result.data.webhooks[].headers.module_parameters[].name` | `string` | No | — | Specify a unique header name. Please note that if you choose Headers, you must add at least one module parameter with a value. If you do not add it, the system will show an error when you try to save the webhook. Maximum length: 255. |
| `result.data.webhooks[].headers.module_parameters[].value` | `string` | No | — | Specify a value of the module header, specified using the merge field format. Example, \$\{!Leads.Email}. Maximum length: 255. |
| `result.data.webhooks[].lock_status` | `object` | No | — | Represents the lock status property of an automation assignment rule, indicating whether the rule is currently locked. |
| `result.data.webhooks[].lock_status.locked` | `boolean` | No | — | Field: locked |
| `result.data.webhooks[].lock_status.message` | `string` | No | — | Field: message Maximum length: 255. |
| `result.data.webhooks[].editable` | `boolean` | No | — | Field: editable |
| `result.data.webhooks[].module` | `object` | Yes | — | Provides details of a module within an automation assignment rule, including API name and module ID. |
| `result.data.webhooks[].module.api_name` | `string` | No | — | Field: api\_name Maximum length: 255. |
| `result.data.webhooks[].module.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.webhooks[].related_module` | `object \| null` | No | — | Nested schema for related\_module |
| `result.data.webhooks[].related_module.api_name` | `string` | No | — | Field: api\_name Maximum length: 255. |
| `result.data.webhooks[].related_module.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.webhooks[].url_parameters` | `record` | No | — | Nested schema for url\_parameters |
| `result.data.webhooks[].deletable` | `boolean` | No | — | Field: deletable |
| `result.data.webhooks[].description` | `string \| null` | No | — | Field: description Maximum length: 255. |
| `result.data.webhooks[].source` | `string \| null` | No | — | Field: source Maximum length: 255. |
| `result.data.webhooks[].body` | `object` | No | — | Defines the structure of the request body for a webhook, including data format and content to be sent during POST and PUT operations. |
| `result.data.webhooks[].body.format` | `"JSON" \| "XML" \| "HTML" \| "Text"` | No | — | Specify the format of the body (Required) Allowed: `JSON`, `XML`, `HTML`, `Text`. Maximum length: 4. |
| `result.data.webhooks[].body.raw_data_content` | `string \| null` | No | — | Use this when you want to send plain text, JSON, HTML, or XML content directly. Maximum length: 500. |
| `result.data.webhooks[].body.type` | `"form_data" \| "raw"` | Yes | — | Specify the body Type (Required) Allowed: `form_data`, `raw`. Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content` | `object` | No | — | Nested schema for form\_data\_content |
| `result.data.webhooks[].body.form_data_content.module_parameters` | `array` | No | — | Field: module\_parameters Maximum items: 1. |
| `result.data.webhooks[].body.form_data_content.module_parameters[].name` | `string` | No | — | Specify a unique header name. Please note that if you choose Headers, you must add at least one module parameter with a value. If you do not add it, the system will show an error when you try to save the webhook. Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content.module_parameters[].value` | `string` | No | — | Specify a value of the module header, specified using the merge field format. Example, \$\{!Leads.Email}. Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content.user_defined_parameter` | `object` | No | — | Nested schema for user\_defined\_parameter |
| `result.data.webhooks[].body.form_data_content.user_defined_parameter.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content.user_defined_parameter.value` | `string` | No | — | Field: value Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content.custom_parameters` | `array` | No | — | Field: custom\_parameters Maximum items: 2. |
| `result.data.webhooks[].body.form_data_content.custom_parameters[].name` | `string` | No | — | Specify a name to the custom header. Maximum length: 255. |
| `result.data.webhooks[].body.form_data_content.custom_parameters[].value` | `string` | No | — | Specify a value to the custom header. Maximum length: 255. |
| `result.data.webhooks[].created_by` | `object` | No | — | Information about the creator of a specific automation assignment rule, including the creator's name and ID. |
| `result.data.webhooks[].created_by.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.webhooks[].created_by.id` | `string` | No | — | Field: id Maximum length: 255. |
| `result.data.webhooks[].url` | `string` | Yes | — | Field: url Maximum length: 255. |
| `result.data.webhooks[].feature_type` | `string` | Yes | — | Field: feature\_type Maximum length: 255. |
| `result.data.webhooks[].http_method` | `string` | Yes | — | Field: http\_method Maximum length: 255. |
| `result.data.webhooks[].modified_time` | `string` | No | — | Field: modified\_time Maximum length: 255. |
| `result.data.webhooks[].associated` | `boolean` | No | — | Field: associated |
| `result.data.webhooks[].name` | `string` | Yes | — | Field: name Maximum length: 255. |
| `result.data.webhooks[].modified_by` | `object` | No | — | Details about the person who last modified a specific automation assignment rule, including their name and ID. |
| `result.data.webhooks[].modified_by.name` | `string` | No | — | Field: name Maximum length: 255. |
| `result.data.webhooks[].modified_by.id` | `string` | No | — | Field: id Maximum length: 255. |
The table shows the first 50 fields. Expand the raw schema below for every field.
This output schema is too large to embed without slowing the page. Get the complete live contract with `deepline tools get zoho_crm_webhooks_get_webhook_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.
## Related documentation
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)