***
title: Configure runners for internal APIs
plan: beta
updated: 2025-11-03T00:00:00.000Z
slug: docs/monitoring-your-api/runners/configure-a-runner
max-toc-depth: 2
----------------
Private API Monitoring is available with [Postman Basic, Professional, and Enterprise plans](https://www.postman.com/pricing/). To enable Private API Monitoring in your Enterprise team, contact your Postman Customer Success Manager.
As an [Admin or Super Admin](/docs/administration/roles-and-permissions/#team-roles), you can use Private API Monitoring to [create a runner](#create-a-runner-when-you-configure-a-monitor) that monitors and tests your organization’s APIs from your internal network, without publicly exposing your endpoints. As an Admin on a Postman Enterprise plan, you can also [create runners from **Runner** settings](#create-a-runner-from-runner-settings).
You can [start the runner](#set-up-a-runner-with-the-postman-cli) with the Postman CLI command from your internal network and securely poll Postman for monitor runs. Once you set up the runner in your internal network, your teammates can [select the runner when creating monitors](#select-the-runner-when-creating-a-monitor). You can [check the monitor results](#check-your-internal-api-monitor) in Postman to learn about your monitor's performance.
## Create a runner when you configure a monitor
As an Admin, you can create a new runner when you configure a monitor. Runners created this way are visible in all your team’s [internal workspaces](/docs/collaborating-in-postman/using-workspaces/internal-workspaces/overview/).
To create a runner when you configure a monitor, do the following:
1. Click 
**Monitors** in the sidebar, then [create or edit a monitor](/docs/monitoring-your-api/setting-up-monitor/).
2. Under **Runners**, select **Manually Select** then click 
**Add Runner**.
3. Give your runner a name and description.
4. Click **Next: Install Runner**.
5. Click 
**Copy to clipboard** to copy the Postman CLI `runner` command with the runner ID and key. Postman identifies a runner using its runner ID, and a runner uses the runner ID and key to authenticate with Postman.
You can't access the runner key again later. You can [reset the runner key](/docs/monitoring-your-api/runners/manage-runners/#reset-a-runner-key) later, if needed.
6. Click **Done**.
7. [Set up the runner in your internal network](/docs/monitoring-your-api/runners/set-up-a-runner-in-your-network/).
## Create a runner from Runner settings
**Runner** settings is available with [Postman Enterprise plans](https://www.postman.com/pricing/) only. To enable Private API Monitoring in your Enterprise team, contact your Postman Customer Success Manager.
As an Admin, you can create a new runner from [**Runner** settings](https://go.postman.co/settings/team/postman-cli).
To create a runner from **Runner** settings, do the following:
1. Select **Organization or team > Organization or team settings** in the Postman header.
2. Click **Runners** in the left sidebar.
3. Click **Add Runner** in the upper right of **Runner** settings.
4. Give your runner a name and description.
5. Choose [internal workspaces](/docs/collaborating-in-postman/using-workspaces/internal-workspaces/overview/) where the runner is visible. Select one of the following:
* **All internal workspaces in team** - The runner is visible in all internal workspaces in your team.
* **Selected workspace** - Click the **Select workspace** dropdown list and then select the internal workspace where the runner is visible.
You can change this later when you're ready to make the runner visible in all your team’s internal workspaces.
6. Click **Next: Install Runner**.
7. Click **Copy to clipboard** to copy the Postman CLI `runner` command with the runner ID and key. Postman identifies a runner using its runner ID, and a runner uses the runner ID and key to authenticate with Postman.
You can't access the runner key again later. You can [reset the runner key](/docs/monitoring-your-api/runners/manage-runners/#reset-a-runner-key) later, if needed.
8. Click **Done**.
9. [Set up the runner in your internal network](/docs/monitoring-your-api/runners/set-up-a-runner-in-your-network/).
Learn how to [manage your runners](/docs/monitoring-your-api/runners/manage-runners/) from **Runner** settings.
## Set up a runner with the Postman CLI
You can get started by learning how to start the runner in your internal network. You can containerize the runner using Docker to set up the runner in your cloud network, like a virtual private cloud. Learn more about [setting up the runner with the Postman CLI](/docs/monitoring-your-api/runners/set-up-a-runner-in-your-network/).
Once the runner is set up and running, your teammates can [select the runner when creating a monitor](#select-the-runner-when-creating-a-monitor).
Your Postman plan gives you a limited number of requests that can be run by your Postman Monitors each month. Requests run by Private API Monitoring count toward this same limit. Learn more about [resource usage in Postman](/docs/billing/resource-usage/#monitoring-usage).
## Select the runner when creating a monitor
When creating a monitor, select a runner to run in your internal network. Runners are only supported in [internal workspaces](/docs/collaborating-in-postman/using-workspaces/internal-workspaces/overview/). After you've created the monitor with the runner, you can [check your monitor's results in Postman](#check-your-internal-api-monitor).
To create a monitor that uses an existing runner, do the following
1. Click **Monitors** in the sidebar, then [create or edit a monitor](/docs/monitoring-your-api/setting-up-monitor/).
2. Under **Run this monitor**, specify how often Postman runs the selected monitor. This can be as often as every five minutes for a status page, or a basic check once a week on your endpoints.
3. Under **Runners**, select **Manually Select** then select a runner.
4. Continue [configuring your monitor](/docs/monitoring-your-api/setting-up-monitor/).
5. Click **Create Monitor**.
## Check your internal API monitor
Your monitor's results show the health and performance of your internal APIs. For more information about Postman Monitor features, see [View monitor results](/docs/monitoring-your-api/viewing-monitor-results/).