This Quickstart walks you through your first API call using Productboard's REST API v2. In just a few steps, you’ll authenticate, send a request, and see real data come back.
1. What You'll Need
- A Productboard account on the Pro plan or higher
- A valid Public API Access Token
- How to generate a token in Workspace Settings
- A terminal with
curlinstalled- 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/v23. 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": "123e4567-e89b-12d3-a456-426614174000",
"type": "textNote",
"fields": {
"name": "Customer feedback",
"content": "Customer reported slow loading times on mobile app",
"owner": {
"id": "923e4567-e89b-12d3-a456-426614174008",
"email": "[email protected]"
},
"creator": {
"id": "e23e4567-e89b-12d3-a456-426614174013",
"email": "[email protected]"
},
"processed": false,
"archived": false
},
"links": {
"self": "https://api.productboard.com/v2/notes/123e4567-e89b-12d3-a456-426614174000"
}
},
{
"id": "223e4567-e89b-12d3-a456-426614174001",
"type": "textNote",
"fields": {
"name": "Feature request – dark mode",
"content": "Customer wants dark mode for the app",
"owner": {
"id": "923e4567-e89b-12d3-a456-426614174008",
"email": "[email protected]"
},
"creator": {
"id": "e23e4567-e89b-12d3-a456-426614174013",
"email": "[email protected]"
},
"processed": true,
"archived": false
},
"links": {
"self": "https://api.productboard.com/v2/notes/223e4567-e89b-12d3-a456-426614174001"
}
}
],
"links": {
"next": "https://api.productboard.com/v2/notes?pageCursor=abc123"
}
}Use the
links.nextfield to paginate through large result sets.
4. What Just Happened?
You:
- Authenticated with a Bearer token
- Sent a
GETrequest to the/notesendpoint - 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:
- Review Rate Limits
- Learn about Pagination