> ## 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: Webhooks Get Webhook By ID

> Get one Zoho CRM webhook by its ID, with its URL, method and parameters. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get one Zoho CRM webhook by its ID, with its URL, method and parameters.

> [!NOTE]
>
> Tool ID: `zoho_crm_webhooks_get_webhook_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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_webhooks_get_webhook_by_id --input '{
  "webhookId": "webhook_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "webhooks": [
      {
        "module": {
          "api_name": "Example",
          "id": "id_123"
        },
        "url": "https://example.com",
        "feature_type": "example",
        "http_method": "example",
        "name": "Example"
      }
    ]
  }
}
```

Use `deepline describe 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. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve the&nbsp;webhooks&nbsp;configured in your Zoho CRM account.",
    "properties": {
      "webhookId": {
        "type": "string",
        "description": "The ID of the webhook to retrieve.",
        "maxLength": 20
      }
    },
    "required": [
      "webhookId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## 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.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe 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](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.