---
title: "Execute Pipeline"
url: https://docs.catalyst.zoho.com/en/sdk/java/v1/pipelines/execute-pipeline/
description: "This page describes the method to run the Catalyst Pipeline manually."
last_updated: 2026-09-08T11:07:33Z
service: All Services
type: general
related_links:
  - name: "JavaScript SDK"
    url: /en/sdk/javascript/v1/pipelines/create-instance/
  - name: "Python SDK"
    url: /en/sdk/python/v1/pipelines/get-pipeline-instance
---

# Execute Pipeline

You can initiate a Catalyst pipeline run by passing the pipeline ID and the branch name as parameters to the `runPipeline()` method. You can also pass environment variables required for the pipeline execution in a JSON object to this method, and it is completely optional. This method returns the execution history details of the pipeline as the response.

```java
JSONObject env = new JSONObject();
env.put("EVENT", "push");
env.put("URL", "https://www.google.com");
ZCPipelineRunHistory run = pipelines_service.runPipeline(8431000000161112051L,main,env);

```

A sample response is shown below:

```java
{
 "status": "success",
 "data": {
 "history_id": "5000000021007",
 "pipeline_id": "8431000000161112051L",
 "event_time": "Mar 20, 2024 02:02 PM",
 "event_details": {
 "BRANCH_NAME": "detective_pre",
 "EVENT": "push",
 "URL": "https://www.google.com"
 },
 "history_status": "Queued"
 }
}

```