***

title: Integrate your Postman tests with Jenkins using Newman
updated: 2025-08-13T00:00:00.000Z
max-toc-depth: 2
----------------

[Jenkins](https://www.jenkins.io/) is an open source automation server that can act as a continuous integration (CI) server or a continuous delivery (CD) hub. Use Newman to integrate your [Postman tests](/docs/tests-and-scripts/write-scripts/test-scripts/) with Jenkins. You can run a Postman Collection and its API tests from Jenkins. You can also specify the frequency that Jenkins runs a collection.

<Info class="iconless-callout">
  This guide uses a Jenkins installation that runs locally, but in most cases you'll run Jenkins on a build server in your production environment.
</Info>

{/* */}

<Info class="iconless-callout">
  **Developing an API?** Postman offers built-in tools to integrate your API with some of the most popular continuous integration (CI) tools, including Jenkins. After you set up CI for your API, you can view the status of builds or kick off a new build, all from within Postman. You can also use Newman to run API tests as part of your CI pipeline. To learn more, see [CI integrations](/docs/integrations/ci-integrations/).
</Info>

## Install Newman in Jenkins

[Install Jenkins](https://www.jenkins.io/doc/book/installing/) if you haven't already, and start it. By default, Jenkins is configured at `http://localhost:8080` if you're running it locally. Install the [NodeJS plugin](https://plugins.jenkins.io/nodejs/) in Jenkins, then install Newman in it.

To install NodeJS in Jenkins, do the following:

1. Click **Manage Jenkins**.
2. Under **System Configuration**, select **Plugins**.
3. Click **Available plugins**, and search for "NodeJS".
4. Select the checkbox next to **NodeJS**, then click **Install**.

To install Newman in Jenkins, do the following:

1. Click **Manage Jenkins**.
2. Under **System Configuration**, select **Tools**.
3. Under **NodeJS installations**, select **Add NodeJS**.
4. Enter a name for the NodeJS installation.
5. In **Global npm packages to install**, enter "Newman".
6. Click **Save**.

## Configure Jenkins

After you [install Newman in Jenkins](#install-newman-in-jenkins), you can configure Jenkins to run a collection using Newman. You'll need a Postman Collection that has at least one request with tests. Then [export the collection as a JSON file](/docs/getting-started/importing-and-exporting/exporting-data/) so you can run it using Newman.

To configure Jenkins to run Newman, do the following:

1. On the **Dashboard** page, click **+ New Item** to create a new job.

2. Select **Freestyle project** from the options, name your project, and click **OK**.

3. On the **Configure** page, click **Build Environment**, and select the checkbox next to **Provide Node & npm bin/ folder to PATH**. Select the NodeJS installation where you installed Newman.

4. Click **Build Steps**, then select **Add build step > Execute shell** to run a shell command. Enter a shell command to [run the collection using Newman](/docs/collections/using-newman-cli/installing-running-newman/#run-a-collection-with-newman), for example:

   ```bash
   newman run ~/Desktop/jenkins_demo_postman_collection.json
   ```

5. Click **Save**.

## Test Newman in Jenkins

{/* vale postman-style-guide.Avoid = NO */}

1. On the **Dashboard** page, select the job you configured to run Newman.

2. Click **Build Now** to manually run the build. After the build runs, review the **Build History** to check if the build succeeded:

   * If the build succeeded, Jenkins indicates this with a green checkmark.

   * If the build failed, Jenkins indicates this with a red cross mark.

3. Select the build from the **Build History**, then click **Console Output** to review the results of the collection run.

4. If the build failed, go to the collection in Postman to fix your tests. Then export the collection as a JSON file, and run the build again.

{/* vale postman-style-guide.Avoid = YES */}

## Specify build frequency

You can configure Jenkins to run Newman at a specified frequency. This enables you to run and test collections from Jenkins on a schedule.

<Info class="iconless-callout">
  In your production environment, you can set up notifications and customize Jenkins to align with your organization's goals.
</Info>

To set the frequency that Jenkins runs Newman, do the following:

{/* vale Vale.Spelling = NO */}

1. On the **Dashboard** page, select the job you configured to run Newman.

2. Click **Configure**.

3. On the **Configure** page, click **Build Triggers**, then select the checkbox next to **Build periodically**.

4. Enter the schedule you'd like the build to run using cron syntax. For example, the following syntax sets the build frequency to every 15 minutes: `H/15 * * * *`.

   <Info class="iconless-callout">
     Click the help icon next to **Schedule** to learn how to specify the build frequency.
   </Info>

5. Click **Save**.

{/* vale Vale.Spelling = YES */}