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

💡

Token generation requires a Productboard account on the Pro plan or higher. Navigate to Settings → Integrations → Public APIs → Access Token and click the + icon.


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
APIURL
Noteshttps://developer.productboard.com/v2/openapi/notes.yaml
Entitieshttps://developer.productboard.com/v2/openapi/entities.yaml
Analyticshttps://developer.productboard.com/v2/openapi/analytics.yaml
Membershttps://developer.productboard.com/v2/openapi/members.yaml
Teamshttps://developer.productboard.com/v2/openapi/teams.yaml
Webhookshttps://developer.productboard.com/v2/openapi/webhooks.yaml
Plugin Integrationshttps://developer.productboard.com/v2/openapi/plugin-integrations.yaml

Option B — Download all specs as a ZIP

Download 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):

  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:
VariableInitial value
baseUrlhttps://api.productboard.com/v2
bearerToken(paste your token here)
  1. 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.

💡

Use the links.next field in the response to paginate through large result sets. See Pagination for details.