Productboard - Paragon Documentation

Note: Productboard API access is restricted to Productboard Pro plans and above. Your users will need to have Productboard Pro plans or above to use this integration.

Connecting to Productboard

Your users will need the following information to connect their Productboard account with your integration built with Paragon Connect:

Productboard API Key

Getting a Productboard API Key

Navigate to Workspace Settings > Integrations > Public API > Access Token

Click + to generate a new token.

Once your users have connected their Productboard account, you can use the Paragon SDK to access the Productboard API on behalf of connected users.

See the Productboard REST API documentation for their full API reference.

Any Productboard API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Get a Feature by ID
paragon.request("productboard", "/features/{id}", {
  method: "GET"
});

// Update a Feature
paragon.request("productboard", "/features/{id}", {
  method: "PATCH",
  body: {
    "data": {
      "name": "Custom branding",
      "description": "<p>Custom <s>branding</s> for the agent and user portals.</p>",
      "archived": true,
      "status": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "In Progress"
      },
      "timeframe": {
        "startDate": "2022-01-01",
        "endDate": "2022-03-31",
        "granularity": "quarter"
      },
      "parent": {
        "feature": {
          "id": "00000000-0000-0000-0000-000000000000"
        }
      },
      "owner": {
        "email": "email@example.com"
      }
    }
  }
});

// Create a new Release
paragon.request("productboard", "/releases", {
  method: "POST",
  body: {
    "data": {
      "name": "R123",
      "description": "<p>Release <s>R123</s></p>",
      "releaseGroup": {
        "id": "00000000-0000-0000-0000-000000000000"
      },
      "timeframe": {
        "startDate": "2023-01-01",
        "endDate": "2023-03-31",
        "granularity": "quarter"
      },
      "state": "upcoming"
    }
  }
});
  

Building Productboard workflows

Once your Productboard account is connected, you can add steps to perform the following actions:

Create Feature

Update Feature

Get Feature by ID

Delete Feature

Create Component

Update Component

Get Component by ID

Get Product by ID

You can also use the Productboard Request step to access any of Productboard’s API endpoints without the authentication piece.

When creating or updating records in Productboard, you can reference data from previous steps by typing {{ to invoke the variable menu.

​Connecting to Productboard

​Getting a Productboard API Key

​Building Productboard workflows

Connecting to Productboard

Getting a Productboard API Key

Building Productboard workflows