New Integration: Gamma

Description

Add Gamma integration to sync AI-generated presentations, documents, and website activity into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/google-docs/ - Similar document-based integration
• integrations/notion/ - Content creation and management integration
• integrations/slack/ - For reference

Required Files Structure

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

Gamma API Integration

Auth Setup

• Use API Key authentication (not OAuth)
• API Key format: sk-gamma-xxxxxxxx
• Pass via X-API-KEY header (not Bearer token)
• Base URL: https://public-api.gamma.app/v1.0/
• API access available on Pro accounts and above

Key Endpoints

• Generate API - Create presentations, documents, webpages, and social posts programmatically
• Create from Template API - Create content based on existing templates
• Retrieve generated content and metadata

API Version

• v1.0 is Generally Available (GA) as of November 5, 2025
• v0.2 is deprecated and sunset on January 16, 2026

Events to Track

1. Presentations - Presentations created, updated, shared
2. Documents - Documents generated, modified
3. Websites - Webpages created or published
4. Social Posts - Social media content generated
5. Templates - Template usage and creation

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement API key authentication flow in account-create.ts
• Create API utilities in utils.ts for v1.0 API
• Implement sync logic in schedule.ts for generated content
• Convert Gamma events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• Gamma uses API Key authentication rather than OAuth 2.0
• API keys are generated from Settings > API key tab in Pro accounts
• The API supports two creation modes: Generate (from scratch) and Create from Template
• v1.0 is the current stable version; ensure no references to deprecated v0.2
• Content types include presentations, documents, webpages, and social posts

Resources

• Gamma Developer Portal
• Gamma API Access & Pricing
• Generate API Parameters
• Create from Template API
• Gamma Help Center - API

Labels

enhancement, integration, new-feature