---
title: "Submit Webhook Job By ID"
url: https://docs.catalyst.zoho.com/en/api/code-reference/job-scheduling/job/submit-job/submit-webhook-job/
description: "This API enables you to submit a job to a Job Pool that triggers a Webhook endpoint."
last_updated: 2026-08-17T12:16:04Z
service: Job Scheduling
type: api
---

# Submit Webhook Job By ID

### Description

This API enables you to submit a job to a Job Pool that triggers a Webhook endpoint.

### Request Details

#### Request URL

`POST` {api-domain}/baas/v1/project/{project_id}/job_scheduling/job

- **project_id** (Numerical): The [unique ID](https://docs.catalyst.zoho.com/en/getting-started/set-up-a-catalyst-project/general-settings/) of the project

#### Request Headers
 **Authorization:** Zoho-oauthtoken {oauth_token} 
**Content-Type:** application/json 

**Optional Headers** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.job.CREATE

#### Request JSON

You must send a JSON with its corresponding values as shown below.

**Sample Payload**

```json

    {
    "request_method": "post",
    "source_type": "API",
    "job_config": {
        "number_of_retries": "2",
        "retry_interval": 1800
    },
    "job_name": "webhookPost",
    "jobpool_id": "10108000003823632",
    "target_type": "Webhook",
    "url": "https://www.zoho.com",
    "headers": {
        "h1": "v1"
    },
    "request_body": "{'key1':'val1'}"
    }

```

You will feed this **Request JSON** to your **Request Body**, and you need to provide the value of:

- **request_method** ( , mandatory):  This denotes the request method the webhook will be triggered with, and the values can be `get`, `post`, `put`, `delete`, `head`, or `patch`.

- **source_type** ( , mandatory):  Will always contain API as its value for submit job API.

- **job_config** (JSON, mandatory):  Will contain the key value pairs `number_of_retries`, and `retry_interval`. This will determine the retry action in the event of a failure.

- **target_type** (String, mandatory):  Will denote which target type the job is meant to trigger.

- **jobpool_id** (Numerical, mandatory): Will contain the [Job Pool ID](https://docs.catalyst.zoho.com/en/job-scheduling/help/jobpool/key-concepts/#job-pool-id) of the job pool that will execute the job.

- **job_name** (String, mandatory):  Will contain the name of the job you are required to trigger.

- **url** (String, mandatory):  Will contain the URL of the webhook the job is going to trigger.

- **headers** (JSON, optional):   Will contain the value of the headers you pass while submitting the job.

- **params** (JSON, optional):   Will contain the value of the params you pass while submitting the job.

### Response Details
The JSON response returns the metadata of the submitted job. The response will also contain the details of the user who submitted the job.

**Sample Request**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/{project_id}/job_scheduling/job
-H "Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57" 
-H "Content-Type:application/json" 
-\-data-raw $'{"request_method":"post","source_type":"API","job_config":{"number_of_retries":"2","retry_interval":1800},"job_name":"webhookPost","jobpool_id":"10108000003823632","target_type":"Webhook","url":"https://www.zoho.com","headers":{"h1":"v1"},"request_body":"{\'key1\':\'val1\'}"}'

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "job_id": "10108000004194125",
        "created_time": "Jun 05, 2024 04:37 PM",
        "response_code": null,
        "start_time": {},
        "end_time": {},
        "submitted_on": {
        "startTimeToRedirectLogsPage": "05/06/2024 16:32",
        "timeWithGivenTimezone": "Jun 05, 2024 04:37 PM IST",
        "timeWithJobTimezone": "Jun 05, 2024 04:37 PM IST"
        },
        "job_status": "PENDING",
        "capacity": {
        "number": "1"
        },
        "job_meta_details": {
        "id": "10108000004194126",
        "url": "https://www.zoho.com",
        "job_name": "webhookPost",
        "job_config": {
            "number_of_retries": 2,
            "retry_interval": 1800
        },
        "target_type": "Webhook",
        "target_details": {
            "target_name": "https://www.zoho.com"
        },
        "source_type": "API",
        "source_details": {
            "source_name": "API"
        },
        "jobpool_id": "10108000003823632",
        "jobpool_details": {
            "type": "Webhook",
            "name": "VendorDataFetch",
            "created_by": {
            "zuid": "77941453",
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia Burrows",
            "last_name": "",
            "user_type": "Admin",
            "user_id": "10108000000009004"
            },
            "created_time": "May 28, 2024 04:47 PM",
            "modified_by": {
            "zuid": "77941453",
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia Burrows",
            "last_name": "",
            "user_type": "Admin",
            "user_id": "10108000000009004"
            },
            "modified_time": "May 28, 2024 04:47 PM",
            "project_details": {
            "project_name": "ZylkerShipments",
            "id": "10108000003823392",
            "project_type": "Live"
            },
            "id": "10108000003823632"
        },
        "headers": {
            "h1": "v1"
        },
        "params": {},
        "request_method": "post",
        "request_body": "{'key1':'val1'}"
        },
        "retried_count": null,
        "parent_job_id": "10108000004194125",
        "execution_time": null
    }
    }

```

### SDK Documentation

[Create Job- Java SDK](https://docs.catalyst.zoho.com/en/sdk/java/v1/job-scheduling/jobs/create-job/)

[Create Job- Node.js SDK](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/job-scheduling/jobs/create-job/)

[Create Job- Python SDK](https://docs.catalyst.zoho.com/en/sdk/python/v1/job-scheduling/jobs/create-job/)