For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Postman
PricingEnterprise
Contact SalesSign InSign Up for Free
HomeDocs
HomeDocs
      • Overview
        • Run and test collections with Newman CLI
        • Install and run Newman
        • Newman command reference
        • Upload files with Newman
        • Use Newman built-in reporters
        • Use Newman external and custom reporters
        • Newman with Docker
        • CI with Newman
        • Travis CI with Newman
        • Jenkins with Newman
        • Migrate to the Postman CLI
Postman API Platform

Product

  • Postman Overview
  • Enterprise
  • Spec Hub
  • Flows
  • Agent Mode
  • API Catalog
  • Fern
  • Postman CLI
  • Integrations
  • Workspaces
  • Plans and pricing

API Network

  • App Security
  • Artificial Intelligence
  • Communication
  • Data Analytics
  • Database
  • Developer Productivity
  • DevOps
  • Ecommerce
  • eSignature
  • Financial Services
  • Payments
  • Travel

Resources

  • Postman Docs
  • Academy
  • Community
  • Templates
  • Intergalactic
  • Videos
  • MCP Servers

Legal and Security

  • Legal Terms Hub
  • Terms of Service
  • Postman Product Terms
  • Security
  • Website Terms of Use

Company

  • About
  • Careers and culture
  • Contact us
  • Partner program
  • Customer stories
  • Student programs
  • Press and media
Twitter iconLinkedIn iconGithub iconYouTube iconInstagram iconDiscord icon
Download Postman
Privacy Policy

© 2026 Postman, Inc.

On this page
  • Prerequisites
  • Install Newman and Node.js
  • Run a collection using Newman and the Postman API
ReferenceNewman CLI

Run Postman Collections in your CI environment using Newman

||View as Markdown|
Was this page helpful?
Previous

Run Newman with Docker on macOS, Ubuntu, and Windows

Next

Integrate your Postman tests with Travis CI using Newman

Built with

You can use Newman and the Postman API to run Postman Collections in your continuous integration (CI) environment. First install Node.js and Newman in your CI environment. You can then use Newman to get and run your collection using the Postman API.

Prerequisites

Before you begin, check the following prerequisites for running collections using Newman and the Postman API:

  • Make sure you have a CI system setup that can run shell commands and that you have edit access.
  • Generate a Postman API key, and copy it for later use.
  • Make sure you have a Postman Collection that tests your localhost server, and copy the collection ID for later use. If your collection needs an environment, copy the environment ID for later use.

Install Newman and Node.js

To learn how to install Newman and Node.js, see Install and run Newman.

You don’t need to install Node.js if your CI environment already has it installed.

Run a collection using Newman and the Postman API

To run a collection using Newman and the Postman API, use the following command:

$newman run "https://api.getpostman.com/collections/collection-id?apikey=postman-api-key"

If you need to provide an environment to the collection, add the --environment option with the appropriate parameters to the Newman command:

$newman run "https://api.getpostman.com/collections/collection-id?apikey=postman-api-key"
$--environment "https://api.getpostman.com/environments/environment-id?apikey=postman-api-key"

Learn more about using Newman with the Postman API.