Overview

What is API v2?

Productboard REST API v2 is the next-generation API designed to offer a cleaner, more consistent, and more scalable developer experience compared to API v1. It reflects how the Productboard data model has evolved and unlocks new possibilities for automation and integrations.

API v2 introduces a new concept: configuration endpoints that describe the shape of data in your workspace. These allow your integration to discover field definitions dynamically, making it easier to build flexible, future-proof integrations.

What APIs are offered?

Currently we offer 8 groups of API:

Notes API
Entities API
Teams API
Members API
Jira Integrations API
Plugin Integrations API
Webhooks API
Analytics API

You can view the 2.0.0 OpenAPI specifications here.

Notes API

The note entity in Productboard represents customer feedback, ideas, conversations, and user insights collected across your product discovery process.

Productboard’s API v2 supports the following note types:

textNote – standard note containing freeform feedback or internal insights
conversationNote – multi-part threaded content (e.g. a chat between a user and support agent)
opportunityNote – structured feedback linked to opportunities (currently read-only via API)

Notes can include:

Text content
Tags
Owners
Customer relationships (user or company)
Relationships to product hierarchy entities (e.g. features, components)

To inspect which fields are available for notes in your workspace, use the Get note configuration endpoint.

For more about how notes are used in Productboard, see:

Entities API

Productboard REST API 2.0 supports a flexible and extensible data model. The following core entity types are available through the /entities endpoints:

product
component
feature
subfeature
initiative
objective
keyResult
release
releaseGroup
user
company

To learn how these entities are structured in your workspace and which fields are available, start with the Get entity configuration or List entities endpoints.

For a deeper understanding of how these concepts map to the Productboard user interface, check out:

Teams API

The Teams API allows you to programmatically manage teams in your Productboard workspace. You can create and update teams, retrieve team details, and manage team membership by adding or removing members.

More information about teams in Productboard can be found in the Organize members into teams guide.

Members API

The Members API gives you access to member data within your workspace. You can list all members, retrieve details for a specific member, and see which teams a member belongs to.

Jira Integrations API

The Jira Integrations API allows you to read the Jira integrations configured in your workspace and inspect their connections to Productboard entities. This is useful for building workflows that bridge your Productboard and Jira data.

Plugin Integrations API

The Plugin Integrations API allows you to create and manage plugin integrations and control their connection states. Use this to build custom integrations that appear and operate inside the Productboard UI.

Webhooks API

The Webhooks API allows you to subscribe to events in Productboard and receive real-time notifications when data changes. This is useful for keeping external systems in sync without polling.

Analytics API

The Analytics API provides access to usage data that helps you understand how Productboard is being adopted and used across your workspace.

You can retrieve metrics related to:

Feature views
User activity and engagement
Note processing trends
Insights usage
Board views and interactions

These metrics can be used to:

Build internal dashboards
Monitor adoption across teams
Identify underused areas of the product
Measure the impact of product initiatives

Analytics data is read-only and typically used for reporting and analysis purposes.
All data is scoped to your workspace and requires appropriate permissions.

To get started, see:

List member activities

Configuration endpoints

Productboard workspaces can be customized with different fields, workflows, and structures — which means the data model isn't static.

To support this flexibility, API v2 introduces /configurations endpoints for each resource type. These endpoints return:

A list of available fields for the resource
A list of available filters for the resource
Metadata about each field (type, label, options, etc.)
How those fields can be used when creating or updating records

Instead of relying on hardcoded assumptions, you can query the /configurations endpoint to understand the current shape of the data — tailored to each workspace.

Example:

GET /notes/configurations

This makes your integration more resilient and adaptable as Productboard evolves. Learn more in the Using Configuration Endpoints guide.

Design principles

This API is built around a few core principles:

Consistency – predictable naming, uniform structure, clear resource models, consistent naming
Flexibility – support for dynamic schemas and workspace-specific configuration
RESTful design – standard HTTP methods, resource-oriented URLs, JSON payloads
Developer experience – intuitive structure, helpful errors, easy to get started

This version builds on everything we learned from API v1, and is designed to support how Productboard is used in complex, real-world workflows.

Authentication

Authentication is required for all requests. We support:

API Token (PAT)
OAuth 2.0 Authorization Code
OAuth 2.0 JWT Bearer

See Authentication for details.

Rate Limits

Rate limits apply to all requests.

50 requests per second per access token
If you exceed this, you'll receive an HTTP 429 response with a Retry-After header

See Rate Limits for more information.

Known issues and limitations

You can find up-to-date known issues and missing functionality in the Known Issues section.