Create a course

post

https://developers.teachable.com/v2/products/courses

Create a new course for the school.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create a new course.

name

string

required

length between 1 and 200

Course name. Required.

description

string | null

Course subtitle/heading.

is_published

boolean

Whether the course is published (accessible to students). Defaults to false.

is_listed

boolean

Whether the course appears in the school's public catalog. Defaults to false.

author_bio_id

integer

required

ID of an author bio belonging to the school. Required. Cannot be changed after creation.

friendly_url

string

length ≤ 100

^[a-zA-Z0-9\-_]+$

URL slug for the course. Allowed characters: letters, numbers, hyphens (-), and underscores (_). If omitted, auto-generated from the course name. Must be unique within the school.

image_url

uri | null

Course image URL. Must be a valid HTTP/HTTPS URL. Extension is not restricted (CDN URLs without extensions are accepted). Maximum 2048 characters. Blank or null clears the image. External URLs are referenced directly and are not downloaded or re-hosted by Teachable. Only files uploaded via the POST /v2/uploads endpoint are stored on Teachable's CDN. The caller is responsible for ensuring externally-hosted media remains available at the provided URL.

Headers

apiKey

string

required

Generated Admin API key

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created

400Invalid request

402Payment Required

404Resource not found

422Validation failed