Postman collection runner CLI for scripted API tests, smoke checks, and CI automation.
$npm install -g newman
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
Newman is Postman's CLI for running Postman Collections outside the Postman app. It is built for repeatable collection execution in local scripts, CI jobs, and other shell-driven test workflows.
What It Enables
- Run exported Postman collections or collection URLs with environments, globals, iteration data, folder selection, timeouts, SSL options, and file uploads.
- Gate smoke tests or CI checks on collection failures, request errors, and script assertions, then export the final environment, globals, collection, or cookie jar after the run.
- Produce run artifacts through built-in CLI, JSON, and JUnit reporters or custom reporters for downstream dashboards, alerts, or archival.
Agent Fit
newman runis stable and non-interactive once inputs are explicit, and its exit-code behavior makes follow-up shell automation straightforward.- Machine-readable output is real but file-oriented: the built-in JSON reporter writes a run summary artifact instead of emitting a generic
--jsonstdout stream. - Best fit when API tests already live as Postman collections and an agent needs to parameterize, execute, and verify those runs from the shell.
Caveats
- It depends on existing Postman collection artifacts or Postman API URLs, so it is less useful for ad hoc request authoring than raw HTTP CLIs.
- Postman's newer Postman CLI covers some newer product surfaces, while Newman stays focused on open-source collection execution and reporter-driven test runs.