POST courses

Creates a new course. A course is a collection of drills held together with a single title, icon and description.

The created course will be empty. The assigned course ID is returned in the response.

Resource URL

https://www.drillster.com/api/2.1.1/courses

Parameters

Field	Description
`name` required	The name of the newly created course. Example value: `French Made Easy`
`description` required	A description of the course. The description is used to tell users about the course to help them decide whether the course is appropriate for them. Example value: `Contains the idiom list from chapters 1 through 12 of the book French Made Easy.`

Response

A 2.1.1 Course object containing the assigned ID.

Example request

POST https://www.drillster.com/api/2.1/courses
name=French+Made+Easy
description=Contains+the+idiom+list+from+chapter+1+through+12+of+the+book+French+Made+Easy.

Response

{
  "id": "R_GVlYZQTKOEmN_r69EVFQ",
  "type": "COURSE"
}

The type is used to differentiate drills from courses, and will be set to COURSE in all cases for this API call.

Error responses

The following error situations are possible:

ID	Description
`no_input`	No input received
`name_missing`	No drill name specified
`description_missing`	No drill description specified

Last updated on 2025-04-18