kit

Capabilities

Kit is an email marketing platform designed for creators to build and monetize their audiences. Agents can leverage Kit’s comprehensive API v4 and plugin system to automate email campaigns, manage subscribers, track purchases, and build custom integrations. The platform supports OAuth 2.0 authentication for secure third-party app development and provides bulk processing capabilities for handling large-scale operations.

Skills

Email Campaign Management

• Create and send broadcasts: Schedule one-time email blasts immediately or for future delivery using /v4/broadcasts endpoints
• Manage email sequences: Set up automated email courses that deliver content over time to nurture leads
• Email template management: Access and utilize email templates through /v4/email-templates endpoints
• Bulk email operations: Process large batches of emails asynchronously with callback support for operations exceeding synchronous limits

Subscriber Management

• Add and update subscribers: Create new subscribers or modify existing ones with custom field data
• Tag management: Organize subscribers using tags for segmentation and targeted campaigns
• Custom fields: Create and manage custom subscriber attributes beyond standard fields (first name, email)
• Subscriber filtering: Use advanced filters to segment audiences for targeted broadcasts
• Bulk subscriber operations: Import or update multiple subscribers simultaneously through /v4/bulk/ endpoints

Purchase and Commerce Tracking

• Track purchases: Record customer transactions with detailed product information using /v4/purchases
• Link purchases to subscribers: Connect transaction data to subscriber profiles for better segmentation
• Multi-currency support: Handle purchases in different currencies with proper formatting
• Product tracking: Monitor individual product performance with SKU, quantity, and pricing data

Automation and Webhooks

• Webhook configuration: Set up automated triggers for subscriber events (e.g., sequence completion)
• Visual automation nodes: Create custom automation workflows that integrate with Kit’s visual builder
• Event-based triggers: Respond to subscriber actions with automated workflows
• Async processing: Handle time-consuming operations with callback URLs for completion notifications

Plugin Development

• Content blocks: Build dynamic HTML elements that creators can insert directly into emails
• Media sources: Integrate external media galleries into Kit’s media library with search and filter capabilities
• Component library: Utilize pre-built UI components (color pickers, date pickers, sliders, etc.) for plugin interfaces
• OAuth integration: Implement secure authentication for plugins to access third-party services

API Features

• Cursor-based pagination: Navigate large datasets efficiently with before/after cursors
• Rate limiting: 120 requests per 60 seconds for API keys, 600 for OAuth applications
• Response codes: Comprehensive error handling with detailed messages for debugging
• Date handling: ISO 8601 format support for all timestamp operations

Workflows

New Subscriber Onboarding

1. Create custom fields for additional subscriber data: POST /v4/custom-fields
2. Add subscriber with custom field values: POST /v4/subscribers
3. Tag subscriber for segmentation: POST /v4/tags/{tag_id}/subscribers
4. Enroll in welcome sequence: POST /v4/sequences/{sequence_id}/subscribers
5. Set up webhook for sequence completion tracking: POST /v4/webhooks

Product Launch Campaign

1. Import customer purchase data: POST /v4/purchases
2. Create broadcast with HTML content: POST /v4/broadcasts
3. Apply subscriber filters for targeting previous customers
4. Schedule broadcast for optimal send time
5. Monitor campaign performance through stats endpoints

Bulk Subscriber Import

1. Prepare subscriber data with custom fields and tags
2. Submit bulk request to /v4/bulk/subscribers with callback URL
3. Handle async processing for large batches (>1000 subscribers)
4. Receive completion notification at callback URL
5. Verify import success and handle any errors

Plugin Integration Setup

1. Create app in Kit App Store dashboard
2. Configure OAuth settings for third-party authentication
3. Build plugin using component library
4. Define settings schema for user configuration
5. Test plugin in sandbox environment
6. Submit for review and publication

Integration

Kit integrates with various platforms and services through:

• OAuth 2.0: Secure authentication for third-party apps with refresh token and PKCE flows
• Webhooks: Real-time event notifications for subscriber actions
• API endpoints: RESTful API supporting JSON payloads
• Plugin system: Native UI extensions for content blocks and media sources
• Bulk processing: Async operations with callback support for large-scale integrations
• AI support: llms.txt file and page-level markdown export for LLM integration

Context

Kit serves over 60,000 creators who collectively send 2.1 billion emails monthly and generate $1.2 million in average monthly sales. The platform focuses on creators who have transformed their expertise into full-time businesses. Key considerations include:

• Plan eligibility: API access requires compatible account plans
• Rate limits: Different limits for API key (120/min) vs OAuth (600/min) authentication
• Bulk thresholds: Operations switch to async processing above documented limits
• V3 deprecation: Legacy V3 API is deprecated; new integrations should use V4
• Creator-focused: Features designed for content creators, course creators, and digital product sellers
• Email-first approach: Core functionality centers around email marketing and subscriber relationships

For additional documentation and navigation, see: https://developers.kit.com/llms.txt