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)
- 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.nextfield in the response to paginate through large result sets. See Pagination for details.
