Gettting started

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?