***

title: Add automated tests and CI integrations in the Postman API Builder
max-toc-depth: 2
---------------------

For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt. For full content including API reference and SDK examples, see https://learning.postman.com/llms-full.txt.

[Testing](https://www.postman.com/api-platform/api-testing/) is a critical part of the API development process. You can create a collection that has your API tests and link it to your API. You can also integrate your API with supported continuous integration (CI) tools.

<Info class="iconless-callout">
  **API testing using the API Builder is available with Postman team plans.** If you are on a Free individual plan, [create a new team](/docs/administration/managing-your-team/create-teams/) to run and automate tests from the API Builder. [Learn more about what's included with each plan](https://www.postman.com/pricing/).
</Info>

<Info class="iconless-callout">
  **Want to take your API testing further?** Learn more about essential API testing techniques, adding test logic with scripts, and more at [Test APIs and write scripts in Postman](/docs/tests-and-scripts/tests-and-scripts/).
</Info>

## Adding API tests

You can connect a test collection (a collection containing API tests) to an API you've defined in the Postman API Builder.

To add a test collection to an API, do the following:

1. Click **APIs** in the sidebar and select an API.
2. Click **Test and Automation**.
3. Next to **Collections**, click <img alt="Add icon" src="https://assets.postman.com/postman-docs/aether-icons/action-add-stroke.svg#icon" width="16px" /> **Add a collection** and select an option:

   * **Copy existing collection** - Select an available collection from the list. A copy of the collection is added to the API.
   * **Generate from definition** - Name and configure a new collection based on the API's definition.
   * **Add new collection** - Create a new empty collection in the API. You can add a request to the collection, then add your tests to the **Post-response** tab.

<img alt="Adding a test collection" src="https://assets.postman.com/postman-docs/v11/api-builder-add-test-collection-v11.jpg" />

<Info class="iconless-callout">
  For more information on how to write API tests, see [Use scripts to add logic and tests to Postman requests](/docs/tests-and-scripts/write-scripts/intro-to-scripts/).
</Info>

## Running API tests

After adding a test collection, you can run the collection to test your API and view test results.

To run a test collection for an API, do the following:

1. Click **APIs** in the sidebar and select an API.
2. Click **Test and Automation**.
3. Under **Collections**, hover over a test collection and click <img alt="Run icon" src="https://assets.postman.com/postman-docs/aether-icons/action-run-stroke.svg#icon" width="16px" /> **Run**.
4. Configure the collection run, then click **Run (collection name)**. Learn more about [configuring collection runs](/docs/collections/running-collections/intro-to-collection-runs/).
5. To view detailed test results, expand the collection and click **View Report** next to a test run.

<img alt="Running a test collection" src="https://assets.postman.com/postman-docs/v10/api-builder-run-test-collection-v10-0-15.jpg" />

<Info class="iconless-callout">
  To remove a test collection from an API, click <img alt="Delete icon" src="https://assets.postman.com/postman-docs/aether-icons/action-delete-stroke.svg#icon" width="16px" /> **Delete** next to the collection.
</Info>

## Adding CI integration

Postman integrates with some of the most widely used continuous integration and continuous delivery (CI/CD) tools. After you set up CI integration for your API, you can view the status of builds or start a new build, all from within Postman. You can also run API tests created in Postman as part of your CI pipeline.

To set up a CI integration for an API, do the following:

1. Click **APIs** in the sidebar and select an API.
2. Click **Test and Automation**.
3. Under **Automate**, select the CI integration you want to add.

<img alt="Connecting to CI/CD" src="https://assets.postman.com/postman-docs/v10/api-builder-automate-v10.jpg" />

To learn more about how CI integrations work, and for detailed configuration steps, see [CI integrations](/docs/integrations/ci-integrations/).