# Teachable

> Run your Teachable school from your workflows: read courses, lectures, quizzes, students, sales and pricing plans, create students, enroll and unenroll them, and mark lectures complete.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/teachable

## Actions

### Create user

Create a student account in your school. Teachable has no way to delete one through the API.

**Inputs**

- Email (`email`, text, required): The new student's email address.
- Name (`name`, text): The new student's name.
- Password (`password`, text): A password for the account, at least 6 characters. Leave empty and the student sets their own.
- Signup source (`source`, text): Where the student came from, such as a campaign name. Teachable shows it on the student's profile.

**Outputs**

- `user` (object): The new user

**Example output**

```json
{
  "user": {
    "courses": [],
    "email": "jo@example.com",
    "id": 2001,
    "last_sign_in_ip": null,
    "name": "Jo Bloggs",
    "role": "student",
    "tags": []
  }
}
```

### Enroll user

Enroll a user in a course.

**Inputs**

- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.
- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.

**Outputs**

- `course_id` (number): The course
- `enrolled` (true/false): Always true once Teachable accepts the request
- `user_id` (number): The student

**Example output**

```json
{
  "course_id": 1001,
  "enrolled": true,
  "user_id": 2001
}
```

### Get course

Get a course with its author and curriculum: every section and the ids of its lectures.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.

**Outputs**

- `course` (object): The course

**Example output**

```json
{
  "course": {
    "author_bio": {
      "bio": null,
      "name": "Jo Baker",
      "profile_image_url": null,
      "user_id": 2002
    },
    "description": null,
    "heading": "Bread from scratch",
    "id": 1001,
    "image_url": null,
    "is_published": true,
    "lecture_sections": [
      {
        "id": 4001,
        "is_published": true,
        "lectures": [
          {
            "id": 5001,
            "is_published": true,
            "position": 1
          }
        ],
        "name": "Getting started",
        "position": 1
      }
    ],
    "name": "Intro to Baking"
  }
}
```

### Get course progress

Get how far one student is through a course: percent complete, completion date, certificate and each lecture.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.
- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `course_progress` (object): The student's progress
- `meta` (object): Paging of the sections

**Example output**

```json
{
  "course_progress": {
    "certificate": {
      "issued_at": null,
      "page_id": null,
      "serial_number": null
    },
    "completed_at": null,
    "enrolled_at": "2026-10-01T09:00:00Z",
    "id": 1001,
    "lecture_sections": [],
    "percent_complete": 10
  },
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}
```

### Get lecture

Get a lecture and its attachments: text, files, videos and quizzes.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Lecture (`lecture_id`, text, required): The lecture in that course. Pick one, or give its id from 'Get course' or an earlier step.

**Outputs**

- `lecture` (object): The lecture

**Example output**

```json
{
  "lecture": {
    "attachments": [],
    "id": 5001,
    "is_published": true,
    "lecture_section_id": 4001,
    "name": "Welcome",
    "position": 1
  }
}
```

### Get pricing plan

Get a pricing plan with its price, billing schedule, trial length and enrollment cap. Only plans for courses are supported.

**Inputs**

- Pricing plan (`pricing_plan_id`, text, required): The pricing plan. Pick one, or give its id from an earlier step.

**Outputs**

- `pricing_plan` (object): The plan

**Example output**

```json
{
  "pricing_plan": {
    "course_id": 1001,
    "created_at": "2026-09-01T09:00:00Z",
    "currency": "USD",
    "description": null,
    "enrollment_cap": null,
    "free_trial_length": null,
    "frequency": {
      "access_limit_date": null,
      "access_limit_duration": null,
      "access_limit_interval": null,
      "billing_interval": null,
      "billing_interval_count": null,
      "type": "one_time"
    },
    "id": 3001,
    "name": "Full price",
    "price": 4900,
    "updated_at": "2026-09-01T09:00:00Z"
  }
}
```

### Get quiz

Get a quiz with its questions, answer choices and correct answers.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Lecture (`lecture_id`, text, required): The lecture in that course. Pick one, or give its id from 'Get course' or an earlier step.
- Quiz ID (`quiz_id`, text, required): The quiz's id, from 'List quizzes' or an earlier step.

**Outputs**

- `quiz` (object): The quiz

**Example output**

```json
{
  "quiz": {
    "id": 5001,
    "kind": "quiz",
    "name": "Quiz 1",
    "position": 1,
    "quiz": {
      "id": 9001,
      "questions": [],
      "type": "Quiz"
    }
  }
}
```

### Get quiz responses

Get every student's submitted result for a quiz: who answered, when, and the percent they got right.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Lecture (`lecture_id`, text, required): The lecture in that course. Pick one, or give its id from 'Get course' or an earlier step.
- Quiz ID (`quiz_id`, text, required): The quiz's id, from 'List quizzes' or an earlier step.

**Outputs**

- `count` (number): How many results
- `course_id` (number): The course
- `course_name` (text): The course's name
- `graded` (true/false): Whether the quiz is graded
- `lecture_id` (number): The lecture
- `lecture_name` (text): The lecture's name
- `responses` (list): The submitted results

**Example output**

```json
{
  "count": 1,
  "course_id": 1001,
  "course_name": "Intro to Baking",
  "graded": true,
  "lecture_id": 5001,
  "lecture_name": "Welcome",
  "responses": [
    {
      "percent_correct": 80,
      "student_email": "jo@example.com",
      "student_id": 2001,
      "student_name": "Jo Bloggs",
      "submitted_at": "2026-10-02T09:00:00Z"
    }
  ]
}
```

### Get user

Get a user with their role, tags and every course they are enrolled in.

**Inputs**

- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "user": {
    "courses": [
      {
        "completed_at": null,
        "course_id": 1001,
        "course_name": "Intro to Baking",
        "enrolled_at": "2026-10-01T09:00:00Z",
        "is_active_enrollment": true,
        "percent_complete": 10
      }
    ],
    "email": "jo@example.com",
    "id": 2001,
    "last_sign_in_ip": null,
    "name": "Jo Bloggs",
    "role": "student",
    "tags": []
  }
}
```

### List course enrollments

List the students enrolled in a course with when they enrolled and how far they have got.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Enrolled after (`enrolled_after`, date and time): Only students who enrolled after this date and time.
- Enrolled before (`enrolled_before`, date and time): Only students who enrolled before this date and time.
- Order (`sort_direction`, text): Which enrollments come first. One of: `asc` (Oldest enrollment first), `desc` (Newest enrollment first).

**Outputs**

- `count` (number): How many records are on this page
- `enrollments` (list): The enrollments
- `meta` (object): Paging: total, page, number_of_pages and so on

**Example output**

```json
{
  "count": 1,
  "enrollments": [
    {
      "completed_at": null,
      "enrolled_at": "2026-10-01T09:00:00Z",
      "expires_at": null,
      "percent_complete": 10,
      "user_id": 2001
    }
  ],
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}
```

### List courses

List the courses in your school, optionally by name, status or author.

**Inputs**

- Name contains (`name`, text): Only courses whose name matches this text.
- Status (`published`, text): Only published or only unpublished courses. Leave empty for both. One of: `published` (Published courses only), `unpublished` (Unpublished courses only).
- Author bio ID (`author_bio_id`, text): Only courses by this author, by the author bio's id.
- Created at (`created_at`, date and time): Only courses created at this date and time.
- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `count` (number): How many records are on this page
- `courses` (list): The courses
- `meta` (object): Paging: total, page, number_of_pages and so on

**Example output**

```json
{
  "count": 1,
  "courses": [
    {
      "description": null,
      "heading": "Bread from scratch",
      "id": 1001,
      "image_url": null,
      "is_published": true,
      "name": "Intro to Baking"
    }
  ],
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}
```

### List pricing plans

List the pricing plans in your school.

**Inputs**

- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `count` (number): How many records are on this page
- `meta` (object): Paging: total, page, number_of_pages and so on
- `pricing_plans` (list): The pricing plans

**Example output**

```json
{
  "count": 1,
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  },
  "pricing_plans": [
    {
      "course_id": 1001,
      "created_at": "2026-09-01T09:00:00Z",
      "currency": "USD",
      "id": 3001,
      "name": "Full price",
      "price": 4900,
      "updated_at": "2026-09-01T09:00:00Z"
    }
  ]
}
```

### List quizzes

List the ids of the quizzes in a lecture.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Lecture (`lecture_id`, text, required): The lecture in that course. Pick one, or give its id from 'Get course' or an earlier step.

**Outputs**

- `count` (number): How many quizzes
- `quiz_ids` (list): The ids of the lecture's quizzes

**Example output**

```json
{
  "count": 1,
  "quiz_ids": [
    5002
  ]
}
```

### List transactions

List the sales in your school with price, tax, revenue and refund details, optionally for one student, course or pricing plan. A new sale can take up to two minutes to appear.

**Inputs**

- Student ID (`student_id`, text): Only this student, by id. Leave empty for everyone.
- Course (`course_id`, text): Only this course. Pick one, or give its id; leave empty for all.
- Pricing plan (`pricing_plan_id`, text): Only sales of this pricing plan. Leave empty for all.
- Refunds (`fully_refunded`, text): Filter by whether the sale was fully refunded. Leave empty for all. One of: `yes` (Only fully refunded sales), `no` (Only sales that are not fully refunded).
- Chargebacks (`chargeback`, text): Filter by whether the sale has a chargeback. Leave empty for all. One of: `yes` (Only sales with a chargeback), `no` (Only sales without a chargeback).
- From (`start`, date and time): Only sales after this date and time (not including it).
- Until (`end`, date and time): Only sales up to this date and time (including it).
- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `count` (number): How many records are on this page
- `meta` (object): Paging: total, page, number_of_pages and so on
- `transactions` (list): The sales

**Example output**

```json
{
  "count": 1,
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  },
  "transactions": [
    {
      "affiliate_fees": 0,
      "affiliate_id": null,
      "amount_refunded": 0,
      "author_fees": 0,
      "author_id": null,
      "charge": 4900,
      "chargeback_fee": null,
      "coupon_id": null,
      "created_at": "2026-10-02T09:00:00Z",
      "currency": "USD",
      "final_price": 4900,
      "has_chargeback": false,
      "id": 9001,
      "pricing_plan_id": 3001,
      "purchased_at": "2026-10-02T09:00:00Z",
      "refunded_at": null,
      "revenue": 4500,
      "sale_id": 9101,
      "status": "paid",
      "tax_charge": 0,
      "user_id": 2001
    }
  ]
}
```

### List users

List the users in your school, or find one by email.

**Inputs**

- Email (`email`, text): Only the user with this email address.
- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `count` (number): How many records are on this page
- `meta` (object): Paging: total, page, number_of_pages and so on
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  },
  "users": [
    {
      "email": "jo@example.com",
      "id": 2001,
      "name": "Jo Bloggs"
    }
  ]
}
```

### List webhook events

List the deliveries of one webhook, with the HTTP status your receiver answered, to find the ones that failed.

**Inputs**

- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its id from 'List webhooks'.
- Response status from (`status_from`, number): Only deliveries your receiver answered with this HTTP status or higher, such as 400 to find failures. From 100 to 599.
- Response status to (`status_to`, number): Only deliveries answered with this HTTP status or lower. From 100 to 599.
- Created after (`created_after`, date and time): Only deliveries created after this date and time.
- Created before (`created_before`, date and time): Only deliveries created before this date and time.
- Page (`page`, number): Which page of results to return. Leave empty for the first. At least 1.
- Results per page (`per`, number): How many results to return on a page, up to 20. Leave empty for Teachable's default. From 1 to 20.

**Outputs**

- `count` (number): How many records are on this page
- `events` (list): The deliveries
- `meta` (object): Paging: total, page, number_of_pages and so on

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "attempt_count": 1,
      "created_at": "2026-10-02T09:00:00Z",
      "id": 7001,
      "last_attempted_at": "2026-10-02T09:00:00Z",
      "object_id": 8001,
      "object_type": "Enrollment",
      "response_http_status": 200,
      "webhook_id": 6001,
      "workflow_state": "delivered"
    }
  ],
  "meta": {
    "from": 1,
    "number_of_pages": 1,
    "page": 1,
    "per_page": 20,
    "to": 1,
    "total": 1
  }
}
```

### List webhooks

List the webhooks set up in your school with the event each one listens for and where it sends it.

**Inputs**: None.

**Outputs**

- `count` (number): How many webhooks
- `meta` (object): Empty: this list is not paged
- `webhooks` (list): The webhooks

**Example output**

```json
{
  "count": 1,
  "meta": {},
  "webhooks": [
    {
      "event_trigger": "Enrollment.created",
      "id": 6001,
      "url": "https://example.com/teachable",
      "webhook_events_count": 12,
      "workflow_state": "active"
    }
  ]
}
```

### Mark lecture complete

Mark a lecture as complete for a student who is enrolled in its course.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Lecture (`lecture_id`, text, required): The lecture in that course. Pick one, or give its id from 'Get course' or an earlier step.
- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.

**Outputs**

- `completed` (true/false): Always true once Teachable accepts the request
- `course_id` (number): The course
- `lecture_id` (number): The lecture
- `user_id` (number): The student

**Example output**

```json
{
  "completed": true,
  "course_id": 1001,
  "lecture_id": 5001,
  "user_id": 2001
}
```

### Unenroll user

Take a user out of a course.

**Inputs**

- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.
- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.

**Outputs**

- `course_id` (number): The course
- `unenrolled` (true/false): Always true once Teachable accepts the request
- `user_id` (number): The student

**Example output**

```json
{
  "course_id": 1001,
  "unenrolled": true,
  "user_id": 2001
}
```

### Update user

Change a user's name or signup source.

**Inputs**

- Student ID (`student_id`, text, required): The student's id, from 'List users' or an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Signup source (`source`, text): A new signup source. Leave empty to keep it.

**Outputs**

- `user` (object): The user after the change

**Example output**

```json
{
  "user": {
    "courses": [
      {
        "completed_at": null,
        "course_id": 1001,
        "course_name": "Intro to Baking",
        "enrolled_at": "2026-10-01T09:00:00Z",
        "is_active_enrollment": true,
        "percent_complete": 10
      }
    ],
    "email": "jo@example.com",
    "id": 2001,
    "last_sign_in_ip": null,
    "name": "Jo Bloggs",
    "role": "student",
    "tags": []
  }
}
```
