***

title: Run API tests on a schedule in Postman
approved: 2026-03-26T00:00:00.000Z
slug: docs/tests-and-scripts/run-tests/run-tests-on-schedule
max-toc-depth: 2
topictype: tutorial
-------------------

In Postman, you can run your [functional API tests](/docs/tests-and-scripts/test-apis/test-apis/) automatically on a schedule. Use the Collection Runner to select a test suite, change the run order of tests, and set the run schedule. Each time the collection runs, you're notified if any tests fail.

During the API development process, you need to repeat tests often to ensure quality. Running each test manually can be time consuming and can lead to gaps in testing. Run your tests on a schedule to save time and effort, enabling you to increase your test coverage. You can also view trends in your API's quality over time.

## Run tests on a schedule

You can organize individual API requests into a test suite using [Postman Collections](/docs/collections/collections-overview/). You can then use the [Collection Runner](/docs/collections/running-collections/scheduling-collection-runs/) to configure when and how often the tests run. With a Postman paid plan, you can also [upload data files](/docs/collections/running-collections/working-with-data-files/) to run tests multiple times using different data each time. Scheduled runs are only supported in the Postman Cloud.

To run a test suite on a schedule, do the following:

1. Click <img alt="Items icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-descriptive-items-stroke.svg#icon" width="20px" /> **Items** in the sidebar.
2. Click **Collections**, select a collection, then click the collection or folder you want to run on a schedule.
3. Click <img alt="Run icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-action-run-stroke.svg#icon" width="20px" /> **Run**.
4. Click the **Functional** tab, then click **Schedule runs**.
5. Enter the name of the scheduled run, then specify the run frequency and time.
6. Select your configuration options, such as the number of iterations you want to run and the [environment](/docs/sending-requests/variables/managing-environments/) to use. You can also upload a JSON or CSV data file to use in your scheduled runs, depending on your Postman plan.
7. (Optional) Select the users you want to notify about test failures and errors.
8. Click **Schedule Run**.

Learn more at [Automate collection runs on a schedule](/docs/collections/running-collections/scheduling-collection-runs/).

## View scheduled test results

Postman runs your test suite on the schedule you configured in the Collection Runner. You can view the results of past test runs. You can also change configuration options, or pause and resume the test schedule.

To view scheduled test runs, do the following:

1. Click <img alt="Items icon" src="https://assets.postman.com/postman-docs/aether-icons/v12/icon-descriptive-items-stroke.svg#icon" width="20px" /> **Items** in the sidebar.
2. Click **Collections**, select a collection, then click the collection or folder you want to view the test results for.
3. Click the **Runs** tab, then click the **Scheduled** tab.
4. Hover over a scheduled run and click **View** to display a graph of all runs.

Each bar in the graph represents a collection run iteration. You can use the graph to understand how your APIs have performed over time. Click a bar in the graph to learn more about the tests that ran during that iteration, such as which tests passed or failed.

Learn more at [View scheduled collection runs in Postman](/docs/collections/running-collections/viewing-scheduled-collection-runs/).