Get webhook by ID

GET/settings/automation/webhooks/{webhookId}

Use it in a workflow

Add a step and choose the Zoho CRM connector.
Pick the Get webhook by ID action (under Webhooks).
Fill in the fields below, then reference the result from later steps as {{getWebhookById.response.data}}.

Request

Path parameters

webhookIdstringrequired

Specify the ID of the webhook to retrieve. Refer to the [Get Webhooks](webhooks.yaml#$.paths./settings/automation/webhooks.get) resource for valid values.

Response

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

webhooksarray<object>

Represents the list containing the single requested webhook object with its full configuration.

created_timestring

Represents the ISO 8601 timestamp of when the webhook was created.

headersobject2 fields

Represents the HTTP headers configuration for the outgoing webhook request. Supports module merge-field parameters and custom static parameters. The host header name is reserved and cannot be used.

lock_statusobject2 fields

Represents the lock status of the webhook. Locked webhooks cannot be edited or deleted.

editableboolean

Indicates whether the current user can edit this webhook. Returns false for marketplace and extension-created webhooks. Possible values: **true** - The webhook can be edited. **false** - The webhook cannot be edited.

moduleobjectrequired2 fields

Represents the CRM module reference identifying the parent module associated with a webhook.

related_moduleobject | null2 fields

Represents a reference to a related CRM module linked to the parent module of a webhook. Returns null when no related module is configured. Required when feature_type is kiosk.

url_parametersobject | null3 fields

Represents the URL query parameters appended to the webhook request URL. Applicable only when http_method is GET or DELETE. Returns null when http_method is POST or PUT.

deletableboolean

Indicates whether the current user can delete this webhook. Returns false for marketplace and extension-created webhooks. Possible values: **true** - The webhook can be deleted. **false** - The webhook cannot be deleted.

descriptionstring | null

Represents the optional user-provided description of the webhook purpose. Returns null when no description has been set.

sourcestring | null

Represents the origin of the webhook. Returns null for legacy webhooks. Possible values: **user** - Created by a CRM user. **crm** - Created by the CRM system. **extension** - Created by a Marketplace extension.

bodyobject4 fields

Represents the request body configuration for the outgoing webhook request. For type **form_data**, provide form_data_content with module_parameters and custom_parameters; format may be null. For type **raw**, supply raw_data_content and a format value of JSON, XML, Text, or HTML. For type **none**, the body carries no content and format may be null.

created_byobject2 fields

Represents the CRM user who created the webhook.

urlstringrequired

Represents the destination URL that Zoho CRM sends the webhook request to when triggered.

feature_typestringrequired

Represents the automation feature type this webhook belongs to. Possible values: **workflow** - Workflow Rule. **approval_process** - Approval Process. **blueprint** - Blueprint. **kiosk** - Kiosk feature. **commandcenter_service** - CommandCenter service.

http_methodstringrequired

Represents the HTTP method used when the webhook fires. Possible values: **GET** - Sends a GET request to the webhook URL. **POST** - Sends a POST request to the webhook URL. **PUT** - Sends a PUT request to the webhook URL. **DELETE** - Sends a DELETE request to the webhook URL.

modified_timestring

Represents the ISO 8601 timestamp of when the webhook was last modified.

associatedboolean

Indicates whether this webhook is currently associated with at least one active Workflow Rule, Approval Process, or Blueprint. Possible values: **true** - The webhook is associated with at least one automation rule. **false** - The webhook is not associated with any automation rule.

namestringrequired

Represents the display name of the webhook.

modified_byobject2 fields

Represents the CRM user who last modified the webhook.

idstring

Represents the unique identifier of the webhook.

date_time_formatobject | null3 fields

Represents the date and time formatting configuration applied to date or datetime merge-field values in webhook request payloads. Applicable only when a date or datetime merge-field is used in headers, url_parameters, or body. Returns null when no date or datetime merge-fields are present.

authenticationobject2 fields

Represents the authentication configuration for the webhook endpoint. Use type **general** for endpoints that do not require credentials. Use type **connection** with a valid connection_name for endpoints that require authenticated access via a pre-configured Zoho connection.

json

{
  "webhooks": [
    {
      "module": {
        "api_name": "string",
        "id": "string"
      },
      "url": "string",
      "feature_type": "string",
      "http_method": "string",
      "name": "string",
      "created_time": "string",
      "headers": {
        "custom_parameters": null,
        "module_parameters": null
      },
      "lock_status": {
        "locked": false,
        "message": "string"
      },
      "editable": false,
      "related_module": {
        "api_name": "string",
        "id": "string"
      },
      "url_parameters": {
        "custom_parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "module_parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "user_defined_parameters": {
          "name": "string",
          "value": "string"
        }
      },
      "deletable": false
    }
  ]
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.

Was this page helpful?