Intercom SDK Upgrade & Migration
Automates the migration of Intercom SDK versions and handles breaking changes between API releases.
This skill provides specialized guidance for upgrading the intercom-client npm package, specifically focusing on the major architectural shift from version 5 to version 6. It assists developers in transitioning from CommonJS to TypeScript/ESM, migrating legacy user and lead operations to the unified Contacts API, and implementing modern async iteration for pagination. By providing targeted code refactoring patterns and automated version checks, it ensures a smooth transition to the latest Intercom API features while maintaining codebase stability and type safety.
Key Features
01API version pinning and Intercom-Version header management
02Step-by-step migration patterns for v5 to v6+ Unified Contacts API
032,024 GitHub stars
04Automated SDK version detection and compatibility checks
05TypeScript type-checking and IntercomError handling refactoring
06Implementation of async iteration for modern cursor-based pagination
Use Cases
01Migrating a legacy Node.js Intercom integration to the latest TypeScript SDK
02Updating error handling logic to support the new structured IntercomError class
03Consolidating separate 'users' and 'leads' logic into the unified Intercom Contacts API