Teachable Plugin for OpenPets

Integrate with the Teachable platform to manage your online courses, students, enrollments, lectures, and sales data programmatically.

Features

• Course Management: Create, read, update courses
• Student Management: List students, manage enrollments
• Content Management: Access lectures and course content
• Sales Analytics: Get revenue and enrollment data
• Read-Only Mode: Safe operation with TEACHABLE_READ_ONLY=true

Setup

1. Get Teachable API Key

1. Go to your Teachable school admin
2. Navigate to Settings > API Keys
3. Click "Create API Key"
4. Copy the API key and save it securely

2. Configure Plugin

Set your environment variables:

# Required
TEACHABLE_API_KEY=your_api_key_here

# Optional (auto-detected if not provided)
TEACHABLE_SCHOOL_ID=your_school_id

3. Enable Read-Only Mode (Optional)

export TEACHABLE_READ_ONLY=true

Available Tools

Connection & Testing

• teachable-test-connection - Test API connection and get school info

Course Management

• teachable-list-courses - List all courses with filtering options
• teachable-get-course - Get detailed course information
• teachable-create-course - Create a new course
• teachable-update-course - Update existing course

Student Management

• teachable-list-students - List students with filters
• teachable-enroll-student - Enroll student in course
• teachable-get-enrollments - Get enrollment details

Content & Analytics

• teachable-list-lectures - Get course lectures and content
• teachable-get-sales-data - Get sales and revenue data

Usage Examples

Basic Course Management

# Test connection
opencode run "test teachable connection"

# List all courses
opencode run "list all teachable courses"

# Get course details
opencode run "get teachable course by ID 123"

# Create new course
opencode run "create new teachable course called 'Introduction to AI'"

Student Management

# List students in a course
opencode run "list students in course 123"

# Enroll a new student
opencode run "enroll student [email protected] in course 123"

Sales Analytics

# Get sales data for last 30 days
opencode run "get teachable sales data for last 30 days"

# Get sales by course
opencode run "get teachable sales data for course 123"

Security & Permissions

Your Teachable API key should have permissions for:

• Courses (read/write)
• Users (read/write for student management)
• Enrollments (read/write)
• Sales (read for analytics)

You can restrict permissions based on your specific needs.

Read-Only Mode

Enable read-only mode to disable all write operations:

• Course creation/updates
• Student enrollments
• Any data modifications

export TEACHABLE_READ_ONLY=true

Error Handling

The plugin provides clear error messages for:

• Invalid API keys
• Missing permissions
• Network connectivity issues
• Invalid parameters

Support

• Teachable API Documentation: Available in your Teachable school admin
• Plugin Issues: Report via GitHub issues
• Setup Help: Check FAQ in package configuration

Compatibility

• OpenCode: ✅ Full support
• Claude: ✅ Full support
• Cursor: ✅ Full support

Requires OpenPets SDK v1.0.0+