Create course

curl --request POST \
  --url https://api.kombo.dev/v1/lms/courses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "url": "<string>",
  "skills": [
    {
      "name": "<string>",
      "skill_level": "<string>"
    }
  ]
}
'

{
  "status": "success",
  "data": {
    "id": "3KMdr68N8kG9EzLwjsN9aoz",
    "remote_id": "42",
    "title": "TypeScript for Beginners",
    "description": "A comprehensive introduction to TypeScript programming, covering types, interfaces, generics, and best practices for modern web development.",
    "url": "https://learning.acme.com/courses/typescript-beginners",
    "remote_created_at": "2022-08-07T14:01:29.196Z",
    "skills": [
      {
        "name": "TypeScript Programming",
        "skill_level": "Beginner"
      },
      {
        "name": "JavaScript Fundamentals",
        "skill_level": "Intermediate"
      }
    ],
    "ordered_content": [],
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null
  }
}

POST

lms

courses

Create course

curl --request POST \
  --url https://api.kombo.dev/v1/lms/courses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "url": "<string>",
  "skills": [
    {
      "name": "<string>",
      "skill_level": "<string>"
    }
  ]
}
'

{
  "status": "success",
  "data": {
    "id": "3KMdr68N8kG9EzLwjsN9aoz",
    "remote_id": "42",
    "title": "TypeScript for Beginners",
    "description": "A comprehensive introduction to TypeScript programming, covering types, interfaces, generics, and best practices for modern web development.",
    "url": "https://learning.acme.com/courses/typescript-beginners",
    "remote_created_at": "2022-08-07T14:01:29.196Z",
    "skills": [
      {
        "name": "TypeScript Programming",
        "skill_level": "Beginner"
      },
      {
        "name": "JavaScript Fundamentals",
        "skill_level": "Intermediate"
      }
    ],
    "ordered_content": [],
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null
  }
}

Closed Beta Feature: This endpoint is currently in closed beta. We’re testing it with selected customers before its public release. If you’re interested in learning more or getting early access, please reach out.

Create a new course in the LMS with a title, description, and associated skills. Content items can be added separately using the content endpoints.

Authorizations

Authorization

string

header

required

Create an API key on the Secrets page in the Kombo dashboard.

Body

application/json

POST /lms/courses Request body

title

string

required

The title of the course

description

string | null

A description of the course

url

string | null

URL where the course can be accessed

skills

object[]

Skills that will be taught in this course

Show child attributes

skills.name

string

required

The name of the skill

skills.skill_level

string | null

The proficiency level of the skill

Response

POST /lms/courses Positive response

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

data.id

string

required

The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.

data.remote_id

string

required

The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key.

data.title

string

required

The title of the course.

data.description

string | null

required

A description of the course.

data.url

string | null

required

URL where the course can be accessed.

data.remote_created_at

string<date-time> | null

required

The date and time the object was created in the remote system.

data.skills

object[] | null

required

Skills that learners will develop by completing this course.

Show child attributes

data.skills.name

string

required

The name of the skill.

data.skills.skill_level

string | null

required

The proficiency level of the skill (e.g., "Beginner", "Intermediate", "Advanced").

data.ordered_content

object[]

required

Ordered list of content items that make up this course.

Show child attributes

data.ordered_content.id

string

required

The Kombo ID of the content item.

data.ordered_content.remote_id

string

required

The remote ID of the content item.

data.ordered_content.title

string

required

The title of the content item.

data.ordered_content.description

string | null

required

A description of the content item.

data.ordered_content.url

string | null

required

URL where the content can be accessed.

data.ordered_content.type

enum<string>

required

The type of learning content.

Available options:

COACHING,

VIDEO,

TEXT,

QUIZ

data.ordered_content.remote_created_at

string<date-time> | null

required

The date and time the object was created in the remote system.

data.changed_at

string<date-time>

required

The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the updated_after parameter which will return records when either the record itself OR its related models have been updated.

data.remote_deleted_at

string | null

required

Date when the course was deleted.

data.remote_data

object

required

Includes the data fetched from the remote system. Please be aware that including this in you scope config might violate other scopes that are set.

Remote data always has the endpoint path that we got the data from as the top level key. For example, it could look like: { "/companies": { ... }}

This is not available on all plans. Reach out to Kombo if you need it.

Get courses Create progress

⌘I

General

Features

Guides

LMS API Reference

General API Reference

Create course

Authorizations

Body

Response