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)

Open Postman and click Import
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

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

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

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

Select this environment as the active environment

Step 4 — Make your first request

Open the imported collection
Select any GET request (e.g. List notes)
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.