🚧
Beta notice
Productboard REST API 2.0 is currently in Beta. Use it for experimentation, prototyping, and early integrations. Please note that individual endpoints may still change before the public release. We’re actively looking for Feedback & Help – let us know what works and what doesn’t. For critical production systems, continue using the Productboard REST API v1.0.

1. What You’ll Need

A Productboard account on the Pro plan or higher
A valid Public API Access Token
- How to generate one in Workspace Settings
A terminal with curl installed
- macOS and most Linux systems include it by default
- On Windows, use Command Prompt, PowerShell, or install curl manually

2. Base URL

All API v2 requests use this base URL:

https://api.productboard.com/v2

3. Make Your First API Call

Follow these steps to fetch data from your workspace using the /notes endpoint.

Step 1 – Open your terminal

Launch your terminal or command line.

Step 2 – Run this command to fetch a list of notes

This request calls the /notes endpoint and retrieves the first page of notes from your workspace.

Replace <your-token> with your actual API access token:

curl -X GET "https://api.productboard.com/v2/notes" \
  -H "Authorization: Bearer <your-token>" \
  -H "Accept: application/json"

Step 3 – Review the response

If everything is set up correctly, you’ll see a JSON response like this:

{
  "data": [
    {
      "id": "note_001",
      "title": "Customer feedback – mobile onboarding"
    },
    {
      "id": "note_002",
      "title": "Feature request – dark mode"
    }
  ],
  "links": {
    "next": "https://api.productboard.com/v2/notes?pageCursor=abc123"
  }
}

💡
Use the links.next field to paginate through large result sets.

4. What Just Happened?

You:

Authenticated with a Bearer token
Sent a GET request to the /notes endpoint
Received a paginated list of notes from your workspace

5. Authentication Methods

This Quickstart uses a Personal Access Token, but we also support:

OAuth 2.0 Authorization Code Flow
OAuth 2.0 JWT Bearer Flow

→ See Authentication for details and examples.

6. What’s Next?

Now that you’ve successfully made your first request, you can:

Explore available endpoints:
- Notes API
- Entities API
Review Rate Limits
Learn about Pagination

Need help or want to share feedback?