New Integration: Productboard

Description

Add Productboard integration to sync features, notes, insights, and product management activity into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/linear/ - Similar product/project management integration
• integrations/github/ - For webhook and event patterns
• integrations/notion/ - Content management integration

Required Files Structure

integrations/productboard/
├── src/
│   ├── index.ts          # Main entry, API token spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # Productboard API utilities
│   ├── account-create.ts # Token setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

Productboard API Integration

Auth Setup

• Use Developer Token authentication (API token generated by admins)
• Token retrieved from workspace Settings > Integrations
• Bearer token in Authorization header

Key Endpoints

• Features API - CRUD operations on features (product backlog items)
• Notes API - Create and manage notes/insights on the Insights board
• Components API - Manage product components
• Products API - List and manage products
• Users API - Workspace user information
• Custom Fields API - Access custom field values on features

API Version

• Productboard API v2 Beta is available with improved structure, custom field support, and better relationship handling

Events to Track

1. Features - Feature created, updated, prioritized, status changed
2. Notes/Insights - Notes created, feedback imported, insights captured
3. Components - Components created, features linked
4. Products - Product hierarchy changes
5. Custom Fields - Custom field value updates on features

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement developer token authentication flow in account-create.ts
• Create API utilities in utils.ts for Productboard API
• Implement sync logic in schedule.ts for features, notes, and components
• Convert Productboard events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• Admin access required to generate developer tokens
• API v2 Beta offers cleaner structure with better custom field and relationship support
• Features API and Notes API are the primary integration points
• Notes API enables importing product feedback from any external source
• Custom fields support enables syncing organization-specific data

Resources

• Productboard Developer Portal
• Notes API for Insights
• Features API
• Developer Portal Support Article
• Productboard API Postman Collection

Labels

enhancement, integration, new-feature

Start by comparing integrations/linear/, integrations/github/src/index.ts, and integrations/notion/ with the required integrations/productboard/ structure. Read the Productboard Developer Portal and the Notes and Features API references before mapping authentication, endpoints, and event formats. Done means the listed files, sync flows, activity conversion, error handling, documentation, and integrations/README.md entry are complete.