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