Changelog

All notable changes to the Teachify Admin API are documented on this page.

January 15, 2026

Early cancellation for subscriptions pending cancellation - The Admin API cancelSubscription mutation now supports immediate cancellation for subscriptions that are already in a pending-cancellation state (isCanceling: true).
- cancelAtPeriodEnd and customEndedAt are ignored in this case (always cancels immediately).

Subscription mutation documentation - Updated Admin API docs for subscription mutations with clearer examples and guidance:
- Early cancellation behavior for cancelSubscription
- Restrictions for updateSubscription when a subscription is pending cancellation

Scheduled cancellation behavior - cancelSubscription(cancelAtPeriodEnd: true) now correctly schedules cancellation (subscription becomes isCanceling: true) instead of cancelling immediately.
Update restrictions for pending cancellations - updateSubscription now blocks updates for isCanceling: true subscriptions and returns an actionable error directing callers to cancelSubscription.

Lifetime Membership Plans - Full support for lifetime membership plan type in the API
- planType: lifetime now available when creating membership plans
- Lifetime plans have no endAt or currentPeriodEnd dates (perpetual access)
- Webhooks now include planType field for membership plan events
- New GraphQL fields:
  - isLifetime on MembershipPlan and Subscription types
  - hasLifetimeAccess on PurchasedCourse type
- Subscription behavior for lifetime plans:
  - isCancellable: false (one-time purchase)
  - nextChargeDate: null (no recurring charges)
Membership Plans Query Filter - New planType filter parameter for membershipPlans query
- Filter by: recurring, fixed_date, specific_length, lifetime

Subscription Documentation - Enhanced documentation for subscription lifecycle and plan types
- Added plan types comparison table
- Clearer explanation of billing cycles and expiration handling

Payment Reporting - Fixed payment_without_invoices_count to accurately count payments missing issued invoices
Subscription Admin - Fixed NoMethodError in admin subscription detail view

Lifetime Subscription Support - Permanent access subscriptions with no expiration
- endAt and currentPeriodEnd return null for lifetime plans
- isCancellable field to indicate if subscription can be cancelled
Invoice Webhook Events - New events for invoice tracking
- invoice.created
- invoice.updated

Student Course Progress Query - Track learner progress through courses
Plan Type Filter - Filter membership plans by planType (recurring, fixed_date, specific_length, lifetime)

Rate Limiting Documentation - Clear limits for API usage
- Mutations: 200 requests per minute
- Queries: 600 requests per minute
Best Practices Guide - Guidelines for effective API usage

Subscription Mutations - Full subscription lifecycle management
- Create subscription
- Update subscription period
- Cancel subscription (at period end or immediately)
Course Access Management
- Expire student course access
- Extend student course access

Initial Admin API Release
- GraphQL endpoint at https://teachify.io/admin/graphql
- Authentication via X-Teachify-API-Key header
Query Operations
- Courses, Users, Coupons, Membership Plans, Events, Assignments
Mutation Operations
- Course CRUD, Student enrollment, Post CRUD, Event creation, Custom email
Webhook Events - 18 event types across 9 categories
Webhook Security - HMAC SHA-256 signature verification, IP allowlisting
OAuth 2.0 Integration - Authorization, Token exchange, User info endpoints
Zapier Integration - Quickstart guide