Productboard is a cloud-based product management platform that allows product teams in an organization to efficiently build and manage their products. It allows you to gather customer feedback and requirements, prioritize features, build roadmaps, define timelines for these features, and engage customers by informing them about these product enhancements on your public portal.
You can replicate the data from your Productboard account to a Destination database or data warehouse using Hevo Pipelines. Productboard uses an access token to identify Hevo and authorize the request for accessing account data. Hevo ingests the data in Full Load mode. Refer to section, Data Model for the list of supported objects.
Prerequisites
-
An active Productboard account with Pro plan and above, from which data is to be ingested, exists.
-
An access token is available to authenticate Hevo on your Productboard account. You must be logged in as an Admin user or as a user with Maker admin access in Productboard to obtain it. Else, you can obtain it from your account administrator.
-
You are assigned the Team Administrator, Team Collaborator, or Pipeline Administrator role in Hevo to create the Pipeline.
Obtaining the Access Token
You require an access token to authenticate Hevo on your Productboard account. The access token does not expire and can be reused for all your Pipelines.
Note: You must log in as an Admin user or as a user with Maker admin access to perform these steps.
To obtain the access token:
-
Log in to your Productboard account and select the workspace in which you want to create the access token. Alternatively, click Create new workspace to create a workspace.
-
Click the Profile icon at the top of the left navigation pane, and click Integrations in the drop-down.
-
On the Integrations page, scroll down to the APIs section and select Access Token.
-
Click + Add token.
-
Click Copy to copy your access token, and save it securely like any other password. Use this token while configuring your Hevo Pipeline. Optionally, you can provide a name for the token in the NAME field to identify your token later.
Configuring Productboard as a Source
Perform the following steps to configure Productboard as the Source in your Pipeline:
-
Click PIPELINES in the Navigation Bar.
-
Click + CREATE PIPELINE in the Pipelines List View.
-
On the Select Source Type page, select Productboard.
-
On the Configure your Productboard Source page, specify the following:
-
Pipeline Name: A unique name for the Pipeline, not exceeding 255 characters.
-
Access Token: The access token that you obtained from your Productboard account.
-
-
Click TEST & CONTINUE.
-
Proceed to configuring the data ingestion and setting up the Destination.
Data Replication
| For Teams Created | Default Ingestion Frequency | Minimum Ingestion Frequency | Maximum Ingestion Frequency | Custom Frequency Range (in Hrs) |
|---|---|---|---|---|
| Before Release 2.21 | 1 Hr | 1 Hr | 24 Hrs | 1-24 |
| After Release 2.21 | 6 Hrs | 30 Mins | 24 Hrs | 1-24 |
Note: The custom frequency must be set in hours as an integer value. For example, 1, 2, or 3 but not 1.5 or 1.75.
Hevo ingests all the objects in Full Load mode in each run of the Pipeline.
Schema and Primary Keys
Hevo uses the following schema to upload the records in the Destination database:
Data Model
The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:
| Object | Description |
|---|---|
| Components | Contains details of the folders created to organize features on feature board. |
| Custom Fields | Contains details of the custom columns added to your feature board. For example, a text, number, or drop-down field. |
| Feature Statuses | Contains the list of statuses that may be used to indicate the current phase of the feature in the product development lifecycle. |
| Features | Contains details of the ideas you are prioritizing and working on for your product. |
| Jira Integrations | Contains the list of Jira accounts integrated with your Productboard account. |
| Objectives | Contains details of the targets you are trying to accomplish for your customers, product, or business. |
| Products | Contains the list of the physical or virtual products or services that are released or are under development by your organization. |
| Release Groups | Contains details of the multiple sets of product releases created in a Productboard workspace, to represent sprints, development cycles, internal releases, or customer-facing launches. |
| Releases | Contains details of the timelines when a product or a new feature might be available for the customers. |
| Users | Contains details of the users who can access your Productboard account. |
Additional Information
Read the detailed Hevo documentation for the following related topics:
Source Considerations
-
Pagination: Each API response for a Productboard object fetches one page with up to 100 records.
-
Rate Limit: Productboard imposes a limit of 50 API calls per minute per access token. If the limit is exceeded, Hevo defers the ingestion till the limits reset. Read Rate Limiting to configure a suitable ingestion frequency for your Pipeline.
-
The access token is available only on PRO and higher plans. Therefore, you must be subscribed to one of these plans to be able to ingest data from your Productboard account.
Limitations
-
Hevo currently does not support deletes. Therefore, any data deleted in the Source may continue to exist in the Destination.
-
You cannot specify a duration for loading the historical data. Hevo loads the entire data present in your Productboard account.
-
Due to schema limitations, Hevo does not support the Custom Field Values and Feature Release Assignments objects.
-
Hevo does not load an Event into the Destination table if its size exceeds 128 MB, which may lead to discrepancies between your Source and Destination data. To avoid such a scenario, ensure that each row in your Source objects contains less than 100 MB of data.
Revision History
Refer to the following table for the list of key updates made to this page:
| Date | Release | Description of Change |
|---|---|---|
| Jan-07-2025 | NA | Updated the Limitations section to add information on Event size. |
| Nov-05-2024 | NA | Updated section, Obtaining the Access Token as per the latest Productboard UI. |
| Mar-05-2024 | 2.21 | Updated the ingestion frequency table in the Data Replication section. |
| Oct-03-2023 | NA | Updated the section, Obtaining the Access Token as per the latest Productboard UI. |
| Jan-23-2022 | 2.06 | New document. |