---
updatedAt: 2026-04-09T10:34:03.000Z
---

Fetch the complete documentation index at: https://developer.productboard.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Explore with Postman

Get up and running with the Productboard API v2 in Postman in under 5 minutes.

## Step 1 — Generate your API token

You'll need a Personal Access Token to authenticate requests.

→ [How to generate an API token](api-token)

<Callout icon="💡" theme="default">
  Token generation requires a Productboard account on the **Pro plan** or higher. Navigate to **Settings → Integrations → Public APIs → Access Token** and click the **+** icon.
</Callout>

***

## Step 2 — Import a spec into Postman

**Option A — Import by URL (recommended)**

1. Open **Postman** and click **Import**
2. Paste one of the URLs below into the input field and click **Import**

| API                 | URL                                                                      |
| ------------------- | ------------------------------------------------------------------------ |
| Notes               | `https://developer.productboard.com/v2/openapi/notes.yaml`               |
| Entities            | `https://developer.productboard.com/v2/openapi/entities.yaml`            |
| Analytics           | `https://developer.productboard.com/v2/openapi/analytics.yaml`           |
| Members             | `https://developer.productboard.com/v2/openapi/members.yaml`             |
| Teams               | `https://developer.productboard.com/v2/openapi/teams.yaml`               |
| Webhooks            | `https://developer.productboard.com/v2/openapi/webhooks.yaml`            |
| Plugin Integrations | `https://developer.productboard.com/v2/openapi/plugin-integrations.yaml` |

**Option B — Download all specs as a ZIP**

[Download productboard-api-v2-specs.zip](https://github.com/productboard/pb-api/releases/download/latest/productboard-api-v2-specs.zip)

Then in Postman, click **Import** and drop the files or select them from the dialog.

***

## Step 3 — Set up your environment

Create a Postman environment so you don't have to repeat the base URL and token on every request ([Postman docs: Managing environments](https://learning.postman.com/docs/sending-requests/variables/managing-environments/)):

1. In Postman, click the **+** icon in the sidebar and select **Environments** (or use the environment selector at the top right of the workbench)
2. Name it `Productboard API v2`
3. Add these two variables:

| Variable      | Initial value                     |
| ------------- | --------------------------------- |
| `baseUrl`     | `https://api.productboard.com/v2` |
| `bearerToken` | *(paste your token here)*         |

4. Select this environment as the active environment

***

## Step 4 — Make your first request

1. Open the imported collection
2. Select any **GET** request (e.g. **List notes**)
3. Click **Send**

You should see a `200 OK` response with a paginated list of results.

<Callout icon="💡" theme="default">
  Use the `links.next` field in the response to paginate through large result sets. See [Pagination](pagination) for details.
</Callout>