homedeveloper-sdk
Developer tools

Developer SDK

Read data from your Teachable school with typed, validated responses and no boilerplate. A free, open source read-only wrapper for the Teachable v1 API, built and maintained by Purple Hippo, with full TypeScript support, Zod-validated responses and a versioned client. My contribution to the Teachable developer community.

Key concepts

TypeScript Native

Every endpoint returns a fully typed response built from real Teachable API payloads rather than guessed from documentation. Import the types directly into your own project for end-to-end type safety.

Zod-Validated Responses

Runtime schema validation via Zod v4 on every API response. If Teachable changes a payload shape, your app surfaces a clear validation error instead of silently passing malformed data downstream.

Versioned Client Pattern

Access endpoints through a versioned client, such as client.v1.users.getList() and client.v1.courses.get(id), so your code stays readable and keeps working as the API evolves.

Get started

terminal

# npm

$npm install optio-teachable

# yarn

$yarn add optio-teachable

example.ts

import { OptioClient } from 'optio-teachable'

const client = new OptioClient({

apiKey: process.env.TEACHABLE_API_KEY

})

const users = await

client.v1.users.getList()

Done for you

Need a custom Teachable integration built?

The SDK covers read operations. If you need write access, OAuth flows or a full custom integration, I can build that layer on top. Most projects in this area run €5k to €15k depending on scope. Get in touch and I'll give you a rough estimate for your requirements.

Tell me about your project