Create a course

curl --location 'https://api.exode.biz/saas/v2/course/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "type": "TextCourse",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "tags": ["safety"],
    "authors": [],
    "modules": [
      {
        "name": "Module 1. Basics",
        "description": "",
        "status": "Published",
        "lessons": [
          {
            "name": "Lesson 1. Why workplace safety matters",
            "description": "",
            "status": "Published",
            "blocks": [
              {
                "type": "EditorJsBlock",
                "content": {
                  "time": 0,
                  "version": "2.29.1",
                  "blocks": [
                    { "id": "h-1", "type": "header", "data": { "text": "Why workplace safety matters", "level": 2 } },
                    { "id": "p-1", "type": "paragraph", "data": { "text": "The rules protect you and your colleagues." } }
                  ]
                }
              }
            ]
          }
        ]
      }
    ]
  }'

const axios = require('axios');

const createCourse = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/course/create', {
      type: 'TextCourse',
      name: 'Workplace safety for new employees',
      description: 'An introductory safety course',
      tags: ['safety'],
      authors: [],
      modules: [
        {
          name: 'Module 1. Basics',
          description: '',
          status: 'Published',
          lessons: [
            {
              name: 'Lesson 1. Why workplace safety matters',
              description: '',
              status: 'Published',
              blocks: [
                {
                  type: 'EditorJsBlock',
                  content: {
                    time: 0,
                    version: '2.29.1',
                    blocks: [
                      { id: 'h-1', type: 'header', data: { text: 'Why workplace safety matters', level: 2 } },
                      { id: 'p-1', type: 'paragraph', data: { text: 'The rules protect you and your colleagues.' } }
                    ]
                  }
                }
              ]
            }
          ]
        }
      ]
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Course created:', response.data.payload);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

createCourse();

<?php

$url = 'https://api.exode.biz/saas/v2/course/create';
$data = [
  'type' => 'TextCourse',
  'name' => 'Workplace safety for new employees',
  'description' => 'An introductory safety course',
  'tags' => ['safety'],
  'authors' => [],
  'modules' => [
    [
      'name' => 'Module 1. Basics',
      'description' => '',
      'status' => 'Published',
      'lessons' => [
        [
          'name' => 'Lesson 1. Why workplace safety matters',
          'description' => '',
          'status' => 'Published',
          'blocks' => [
            [
              'type' => 'EditorJsBlock',
              'content' => [
                'time' => 0,
                'version' => '2.29.1',
                'blocks' => [
                  ['id' => 'h-1', 'type' => 'header', 'data' => ['text' => 'Why workplace safety matters', 'level' => 2]],
                  ['id' => 'p-1', 'type' => 'paragraph', 'data' => ['text' => 'The rules protect you and your colleagues.']]
                ]
              ]
            ]
          ]
        ]
      ]
    ]
  ]
];

$headers = [
  'Seller-Id: {{ sellerId }}',
  'School-Id: {{ schoolId }}',
  'Content-Type: application/json',
  'Authorization: Bearer YOUR_TOKEN'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
  $result = json_decode($response, true);
  echo "Course created: " . $result['payload']['id'] . "\n";
} else {
  echo "Error: HTTP $httpCode\n";
  echo $response;
}
?>

import requests

url = 'https://api.exode.biz/saas/v2/course/create'

data = {
  'type': 'TextCourse',
  'name': 'Workplace safety for new employees',
  'description': 'An introductory safety course',
  'tags': ['safety'],
  'authors': [],
  'modules': [
    {
      'name': 'Module 1. Basics',
      'description': '',
      'status': 'Published',
      'lessons': [
        {
          'name': 'Lesson 1. Why workplace safety matters',
          'description': '',
          'status': 'Published',
          'blocks': [
            {
              'type': 'EditorJsBlock',
              'content': {
                'time': 0,
                'version': '2.29.1',
                'blocks': [
                  { 'id': 'h-1', 'type': 'header', 'data': { 'text': 'Why workplace safety matters', 'level': 2 } },
                  { 'id': 'p-1', 'type': 'paragraph', 'data': { 'text': 'The rules protect you and your colleagues.' } }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

ВнутреннийБлок = Новый Структура;
ВнутреннийБлок.Вставить("id", "p-1");
ВнутреннийБлок.Вставить("type", "paragraph");
ВнутреннийБлок.Вставить("data", Новый Структура("text", "The rules protect you and your colleagues."));

СодержимоеБлока = Новый Структура;
СодержимоеБлока.Вставить("time", 0);
СодержимоеБлока.Вставить("version", "2.29.1");
СодержимоеБлока.Вставить("blocks", Новый Массив);
СодержимоеБлока.blocks.Добавить(ВнутреннийБлок);

Блок = Новый Структура;
Блок.Вставить("type", "EditorJsBlock");
Блок.Вставить("content", СодержимоеБлока);

Урок = Новый Структура;
Урок.Вставить("name", "Lesson 1. Why workplace safety matters");
Урок.Вставить("description", "");
Урок.Вставить("status", "Published");
Урок.Вставить("blocks", Новый Массив);
Урок.blocks.Добавить(Блок);

Модуль = Новый Структура;
Модуль.Вставить("name", "Module 1. Basics");
Модуль.Вставить("description", "");
Модуль.Вставить("status", "Published");
Модуль.Вставить("lessons", Новый Массив);
Модуль.lessons.Добавить(Урок);

Данные = Новый Структура;
Данные.Вставить("type", "TextCourse");
Данные.Вставить("name", "Workplace safety for new employees");
Данные.Вставить("description", "An introductory safety course");
Данные.Вставить("tags", Новый Массив);
Данные.tags.Добавить("safety");
Данные.Вставить("authors", Новый Массив);
Данные.Вставить("modules", Новый Массив);
Данные.modules.Добавить(Модуль);

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Данные);
ТелоЗапроса = ЗаписьJSON.Закрыть();

Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 60, Новый OpenSSLSecureConnection);

Запрос = Новый HTTPЗапрос("/saas/v2/course/create");
Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}");
Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса);

Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

Если Ответ.КодСостояния = 201 Тогда
    Сообщить("Course created");
Иначе
    Сообщить("Error: HTTP " + Ответ.КодСостояния);
    Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 412,
    "createdAt": "2026-09-28T09:12:03.518Z",
    "updatedAt": "2026-09-28T09:12:03.941Z",
    "archivedAt": null,
    "type": "TextCourse",
    "productId": 1290,
    "buildStatus": "Ready",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "alias": null,
    "tags": [
      "safety"
    ],
    "seoTags": [],
    "image": {
      "main": ""
    },
    "promoVideo": null,
    "settings": {
      "editorAccessMode": "All",
      "curatorAccessMode": "All"
    },
    "order": 0,
    "isBundle": false
  }
}

{
  "code": 400,
  "success": false,
  "cause": "validation",
  "message": [
    "modules.0.lessons.0.name must be shorter than or equal to 120 characters"
  ],
  "error": "Bad Request"
}

{
  "code": 402,
  "success": false,
  "cause": "SaasLimitReached",
  "message": "School plan limit reached: maxActiveProducts (10/10)",
  "error": "School plan limit reached: maxActiveProducts (10/10)",
  "data": {
    "max": 10,
    "current": 10,
    "feature": "maxActiveProducts"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "AliasAlreadyBusy",
  "message": "Этот адрес уже занят",
  "error": "Этот адрес уже занят"
}

{
  "code": 400,
  "success": false,
  "cause": "CertificateTemplateRequired",
  "message": "Certificate template is required",
  "error": "Certificate template is required"
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "message": "Forbidden seller resource - permissions CourseManage",
  "error": "Forbidden seller resource - permissions CourseManage"
}

curl --location 'https://api.exode.biz/saas/v2/course/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "type": "TextCourse",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "tags": ["safety"],
    "authors": [],
    "modules": [
      {
        "name": "Module 1. Basics",
        "description": "",
        "status": "Published",
        "lessons": [
          {
            "name": "Lesson 1. Why workplace safety matters",
            "description": "",
            "status": "Published",
            "blocks": [
              {
                "type": "EditorJsBlock",
                "content": {
                  "time": 0,
                  "version": "2.29.1",
                  "blocks": [
                    { "id": "h-1", "type": "header", "data": { "text": "Why workplace safety matters", "level": 2 } },
                    { "id": "p-1", "type": "paragraph", "data": { "text": "The rules protect you and your colleagues." } }
                  ]
                }
              }
            ]
          }
        ]
      }
    ]
  }'

const axios = require('axios');

const createCourse = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/course/create', {
      type: 'TextCourse',
      name: 'Workplace safety for new employees',
      description: 'An introductory safety course',
      tags: ['safety'],
      authors: [],
      modules: [
        {
          name: 'Module 1. Basics',
          description: '',
          status: 'Published',
          lessons: [
            {
              name: 'Lesson 1. Why workplace safety matters',
              description: '',
              status: 'Published',
              blocks: [
                {
                  type: 'EditorJsBlock',
                  content: {
                    time: 0,
                    version: '2.29.1',
                    blocks: [
                      { id: 'h-1', type: 'header', data: { text: 'Why workplace safety matters', level: 2 } },
                      { id: 'p-1', type: 'paragraph', data: { text: 'The rules protect you and your colleagues.' } }
                    ]
                  }
                }
              ]
            }
          ]
        }
      ]
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Course created:', response.data.payload);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

createCourse();

<?php

$url = 'https://api.exode.biz/saas/v2/course/create';
$data = [
  'type' => 'TextCourse',
  'name' => 'Workplace safety for new employees',
  'description' => 'An introductory safety course',
  'tags' => ['safety'],
  'authors' => [],
  'modules' => [
    [
      'name' => 'Module 1. Basics',
      'description' => '',
      'status' => 'Published',
      'lessons' => [
        [
          'name' => 'Lesson 1. Why workplace safety matters',
          'description' => '',
          'status' => 'Published',
          'blocks' => [
            [
              'type' => 'EditorJsBlock',
              'content' => [
                'time' => 0,
                'version' => '2.29.1',
                'blocks' => [
                  ['id' => 'h-1', 'type' => 'header', 'data' => ['text' => 'Why workplace safety matters', 'level' => 2]],
                  ['id' => 'p-1', 'type' => 'paragraph', 'data' => ['text' => 'The rules protect you and your colleagues.']]
                ]
              ]
            ]
          ]
        ]
      ]
    ]
  ]
];

$headers = [
  'Seller-Id: {{ sellerId }}',
  'School-Id: {{ schoolId }}',
  'Content-Type: application/json',
  'Authorization: Bearer YOUR_TOKEN'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
  $result = json_decode($response, true);
  echo "Course created: " . $result['payload']['id'] . "\n";
} else {
  echo "Error: HTTP $httpCode\n";
  echo $response;
}
?>

import requests

url = 'https://api.exode.biz/saas/v2/course/create'

data = {
  'type': 'TextCourse',
  'name': 'Workplace safety for new employees',
  'description': 'An introductory safety course',
  'tags': ['safety'],
  'authors': [],
  'modules': [
    {
      'name': 'Module 1. Basics',
      'description': '',
      'status': 'Published',
      'lessons': [
        {
          'name': 'Lesson 1. Why workplace safety matters',
          'description': '',
          'status': 'Published',
          'blocks': [
            {
              'type': 'EditorJsBlock',
              'content': {
                'time': 0,
                'version': '2.29.1',
                'blocks': [
                  { 'id': 'h-1', 'type': 'header', 'data': { 'text': 'Why workplace safety matters', 'level': 2 } },
                  { 'id': 'p-1', 'type': 'paragraph', 'data': { 'text': 'The rules protect you and your colleagues.' } }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

ВнутреннийБлок = Новый Структура;
ВнутреннийБлок.Вставить("id", "p-1");
ВнутреннийБлок.Вставить("type", "paragraph");
ВнутреннийБлок.Вставить("data", Новый Структура("text", "The rules protect you and your colleagues."));

СодержимоеБлока = Новый Структура;
СодержимоеБлока.Вставить("time", 0);
СодержимоеБлока.Вставить("version", "2.29.1");
СодержимоеБлока.Вставить("blocks", Новый Массив);
СодержимоеБлока.blocks.Добавить(ВнутреннийБлок);

Блок = Новый Структура;
Блок.Вставить("type", "EditorJsBlock");
Блок.Вставить("content", СодержимоеБлока);

Урок = Новый Структура;
Урок.Вставить("name", "Lesson 1. Why workplace safety matters");
Урок.Вставить("description", "");
Урок.Вставить("status", "Published");
Урок.Вставить("blocks", Новый Массив);
Урок.blocks.Добавить(Блок);

Модуль = Новый Структура;
Модуль.Вставить("name", "Module 1. Basics");
Модуль.Вставить("description", "");
Модуль.Вставить("status", "Published");
Модуль.Вставить("lessons", Новый Массив);
Модуль.lessons.Добавить(Урок);

Данные = Новый Структура;
Данные.Вставить("type", "TextCourse");
Данные.Вставить("name", "Workplace safety for new employees");
Данные.Вставить("description", "An introductory safety course");
Данные.Вставить("tags", Новый Массив);
Данные.tags.Добавить("safety");
Данные.Вставить("authors", Новый Массив);
Данные.Вставить("modules", Новый Массив);
Данные.modules.Добавить(Модуль);

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Данные);
ТелоЗапроса = ЗаписьJSON.Закрыть();

Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 60, Новый OpenSSLSecureConnection);

Запрос = Новый HTTPЗапрос("/saas/v2/course/create");
Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}");
Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса);

Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

Если Ответ.КодСостояния = 201 Тогда
    Сообщить("Course created");
Иначе
    Сообщить("Error: HTTP " + Ответ.КодСостояния);
    Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 412,
    "createdAt": "2026-09-28T09:12:03.518Z",
    "updatedAt": "2026-09-28T09:12:03.941Z",
    "archivedAt": null,
    "type": "TextCourse",
    "productId": 1290,
    "buildStatus": "Ready",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "alias": null,
    "tags": [
      "safety"
    ],
    "seoTags": [],
    "image": {
      "main": ""
    },
    "promoVideo": null,
    "settings": {
      "editorAccessMode": "All",
      "curatorAccessMode": "All"
    },
    "order": 0,
    "isBundle": false
  }
}

{
  "code": 400,
  "success": false,
  "cause": "validation",
  "message": [
    "modules.0.lessons.0.name must be shorter than or equal to 120 characters"
  ],
  "error": "Bad Request"
}

{
  "code": 402,
  "success": false,
  "cause": "SaasLimitReached",
  "message": "School plan limit reached: maxActiveProducts (10/10)",
  "error": "School plan limit reached: maxActiveProducts (10/10)",
  "data": {
    "max": 10,
    "current": 10,
    "feature": "maxActiveProducts"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "AliasAlreadyBusy",
  "message": "Этот адрес уже занят",
  "error": "Этот адрес уже занят"
}

{
  "code": 400,
  "success": false,
  "cause": "CertificateTemplateRequired",
  "message": "Certificate template is required",
  "error": "Certificate template is required"
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "message": "Forbidden seller resource - permissions CourseManage",
  "error": "Forbidden seller resource - permissions CourseManage"
}

Request headers

string

required

The service user’s API token in the Bearer YOUR_TOKEN format. The school owner issues the token in the admin panel: Manage → School → For developers → API keys — see the “Authentication” section for details.

integer

required

The numeric ID of the seller — the account the school belongs to. Copy it on the API keys page, in the Integration data → Identifiers card. The token’s permissions are checked against this ID.

integer

required

The numeric ID of the school, found in the same place as Seller-Id. The value must match the seller’s school — otherwise a 400 error with cause: "ForbiddenSchoolMismatch" is returned.

POST /saas/v2/course/create

Requires authentication and the “Course Management” permission (CourseManage). The method is available to schools only. The method creates a course with the same parameters as the “Create course” button in the admin panel. If you pass modules, the whole course tree is created in the same request: modules, lessons inside them and the content blocks of each lesson. Without modules an empty course is created — lessons can be added later in the admin panel.

Created automatically together with the course:

the course product — published right away; its ID is returned in the productId field of the response;
a default group (“Group 1”) — you can enroll users into it. List groups with the courseIds filter returns the group ID.

The API key’s user becomes an author of the course and is assigned as its editor, so the created course is available to this key in update and get even when the course uses the “Assigned” access mode.

Creation is not atomic. The course, modules, lessons and blocks are written one after another, without a shared transaction. Body validation errors are returned before anything is written, so nothing gets created. But if the request breaks off in the middle of writing (a dropped connection, a timeout, a server failure), the part created so far stays in the school and the course is left incomplete. Repeating the request creates a new course rather than completing the previous one — delete the incomplete course or finish it in the admin panel.

Unknown fields in the request body are silently dropped — no error is returned. Check field names against this page.

Request parameters

Course

enum

required

Course type: TextCourse, VideoCourse, Webinar, Assessment, PersonalLesson, Bundle.

string

required

Course name. 1 to 130 characters; leading and trailing spaces are trimmed.

string

required

Course description. Up to 500 characters; may be an empty string "".

string[]

required

Course tags, each at least 2 characters long. Pass [] if there are none.

integer[]

required

IDs of school users listed as course authors. The API key’s user is added automatically. Pass [] if there are no other authors.

string

Course URL alias: Latin letters, digits and _. Cannot consist of digits only and must be unique.

object

Course images.

Show image properties

string

Main image URL.

string

Course card image URL.

Link to the course promo video.

string[]

SEO tags.

integer[]

IDs of the course subject categories.

integer

ID of the course content category.

object

Course settings. All fields are optional.

Show settings properties

enum

Learning path: ByOrder — in lesson order, ByUser — in any order.

enum

Lesson unlocking: Free — all at once, Sequence — the next one after the previous is completed.

enum

Which school team members see the course as editors: All — everyone with “Course Management”, Assigned — only those assigned to the course. Defaults to All; Assigned for corporate schools.

enum

The same for curators: All or Assigned. Defaults to the editorAccessMode default.

boolean

Hide module numbering.

boolean

Hide the participant count.

boolean

Enable gamification (stars) in the course.

integer

Default stars for completing a lesson, 0 or more.

integer

Default stars for a correct task answer, 0 or more.

boolean

Screen recording protection.

boolean

Disable text copying.

boolean

Hide course feedback.

boolean

Hide lesson ratings.

enum

How ratings are collected: ByLesson — after each lesson, ByModule — after a module.

enum

Curator chat: Hidden, Platform (Exode chat) or External (external link from curatorChatUrl).

string

External curator chat link (with curatorChatMode: External). Up to 255 characters.

string

Custom link (URL) the course card leads to.

object

Completion certificate: enabled, templateId (required with enabled: true; the template must be available to the school), expireInMonths, brandColor (HEX), signatureImageUrl, stampImageUrl, curatorName, curatorRole (up to 255 characters).

object

Course product parameters. If omitted, the product is created with the default settings.

Show product properties

enum

required

Product type: Course. Required if the product object is passed.

enum

Currency: Free, Rub, Uzs, Kzt, Usd, Eur.

boolean

Whether to show the course in the school catalog. Defaults to false for corporate schools.

enum[]

Enrollment methods (non-empty array): ByAssignment, ByInviteLink, ByApplication, BySelfEnrollment.

string

Sales start (ISO 8601), not later than saleFinishAt.

string

Sales end (ISO 8601), not earlier than saleStartAt.

object[]

For type: Bundle only — courses included in the bundle (up to 50). The courses and their groups must belong to the same school.

Show Item properties

integer

required

ID of a course included in the bundle.

integer | null

Group of that course to enroll bundle participants into. A group may appear in at most one row.

integer[]

Groups of the bundle itself the row applies to.

The buildStatus and aiContext fields are internal — they are filled in by the AI course wizard. Do not pass them: with buildStatus: AiGenerating the course is hidden from everyone except its author.

Modules and lessons

object[]

Course modules — up to 50. The order of modules, lessons and blocks in the course follows the order in the arrays.

Show Module properties

string

required

Module name. Up to 120 characters.

string

required

Module description. Up to 500 characters; may be "".

enum

Status: Draft, OnCheck or Published. Defaults to Draft.

enum

Access: Participant — course participants only (default), Demo — open as a demo.

string

Module preview URL.

object[]

required

Module lessons — up to 100.

Show Lesson properties

string

required

Lesson name. Up to 120 characters.

string

required

Lesson description. Up to 500 characters; may be "".

enum

Status: Draft, OnCheck or Published. Defaults to Draft.

enum

Lesson type: Regular (default) or Webinar.

enum

Access: Participant (default) or Demo.

string

Lesson preview URL.

boolean

Create an empty practice for the lesson — tasks are added in the admin panel. Defaults to false.

object

Lesson settings: starsForCompletion (stars for completion, 0 or more), videoWatchPercentThreshold (percentage of the video to watch, 1 to 100), scorm (completionThreshold from 1 to 100, requireNotFailed).

object[]

Lesson content blocks — up to 100. See Content blocks.

Modules and lessons are created as Draft — students do not see them. To make the materials available right away, pass status: "Published" for modules and lessons. Do not pass parentLessonId: modules and lessons are linked by array nesting.

Content blocks

Each lesson block is an object with the fields:

enum

required

Block type. For lessons: EditorJsBlock, TaskQuestion, Checklist, Button, Checkpoint, ChatMessage, Video, Iframe, NotionPage. Other values (Text, Audio, Scorm, Survey and promo block types) are not recommended for creation via the API.

string

Heading shown above the block in the lesson.

object

required

Block content. Its shape depends on type — see the examples below.

The API does not validate content: the block is saved as passed. A block with the wrong content shape is created but renders empty or broken in the lesson. Check the shape against the examples. Generate every uuid inside content on your side (UUID v4), unique within the block. Blocks with files (uploaded video, audio, a SCORM package) cannot be created via the API — the file is uploaded in the admin panel.

EditorJsBlock — text

The main block for theory: headings, paragraphs, lists, quotes, tables and a delimiter. content is an EditorJS document. The text may use <b>, <i>, <u>, <a> tags.

{
  "type": "EditorJsBlock",
  "content": {
    "time": 0,
    "version": "2.29.1",
    "blocks": [
      { "id": "h-1", "type": "header", "data": { "text": "Why workplace safety matters", "level": 2 } },
      { "id": "p-1", "type": "paragraph", "data": { "text": "The rules protect <b>you</b> and your colleagues." } },
      { "id": "l-1", "type": "list", "data": { "style": "unordered", "items": ["Helmet", "Gloves"] } },
      { "id": "q-1", "type": "quote", "data": { "text": "Safety first.", "caption": "Handbook" } },
      { "id": "d-1", "type": "delimiter", "data": {} },
      { "id": "t-1", "type": "table", "data": { "withHeadings": true, "content": [["Equipment", "When"], ["Helmet", "Always"]] } }
    ]
  }
}

Inner block ids are arbitrary unique strings. A header level is 2 or 3; a list style is unordered or ordered.

TaskQuestion — auto-checked question

A question with answer options, checked right in the lesson. answerType: Single — one correct option, Multiple — several.

{
  "type": "TaskQuestion",
  "title": "Check yourself",
  "content": {
    "uuid": "7f1c2a4e-3b5d-4c6e-8f9a-0b1c2d3e4f50",
    "task": {
      "title": "Who conducts the induction briefing?",
      "answerType": "Single",
      "question": {
        "variants": [
          { "uuid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "text": "A safety officer", "correct": true },
          { "uuid": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "text": "The employee", "correct": false }
        ]
      }
    },
    "messages": {
      "correct": "Correct — a safety officer conducts it.",
      "incorrect": "The briefing is conducted by a safety officer."
    }
  }
}

messages is optional. When set, the blocks below the question stay hidden until the student answers.

Checklist

{
  "type": "Checklist",
  "content": {
    "items": [
      { "uuid": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "text": "Read the instructions" },
      { "uuid": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f6a", "text": "Sign the logbook" }
    ]
  }
}

Button — link button

{
  "type": "Button",
  "content": {
    "buttons": [
      { "uuid": "e3f4a5b6-c7d8-4e9f-0a1b-2c3d4e5f6a7b", "text": "Open the policy", "link": "https://example.com/rules", "target": "_blank" }
    ]
  }
}

target is _blank (new tab) or _self.

Checkpoint — "Continue" button

A divider button: everything below stays hidden until the student presses it.

{
  "type": "Checkpoint",
  "content": { "uuid": "f4a5b6c7-d8e9-4f0a-1b2c-3d4e5f6a7b8c", "text": "Got it, continue" }
}

ChatMessage — messages from a mentor

{
  "type": "ChatMessage",
  "content": {
    "senderName": "Anna, mentor",
    "messages": [
      { "uuid": "a5b6c7d8-e9f0-4a1b-2c3d-4e5f6a7b8c9d", "text": "Hi! Today we cover workplace safety." }
    ]
  }
}

Video — video by link

A video from a video host (YouTube, Vimeo, Kinescope) — by link, without uploading a file.

{
  "type": "Video",
  "title": "Introductory lecture",
  "content": { "type": "ThirdParty", "location": "https://www.youtube.com/watch?v=VIDEO_ID" }
}

Iframe — embedded page

{
  "type": "Iframe",
  "content": { "src": "https://example.com/embed" }
}

NotionPage — Notion page

A public Notion page, displayed inside the lesson.

{
  "type": "NotionPage",
  "content": { "notionUrl": "https://example.notion.site/Page-Title-0123456789abcdef0123456789abcdef" }
}

Response fields

object

The created course — a course object. The module and lesson tree is not included in the response.

curl --location 'https://api.exode.biz/saas/v2/course/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "type": "TextCourse",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "tags": ["safety"],
    "authors": [],
    "modules": [
      {
        "name": "Module 1. Basics",
        "description": "",
        "status": "Published",
        "lessons": [
          {
            "name": "Lesson 1. Why workplace safety matters",
            "description": "",
            "status": "Published",
            "blocks": [
              {
                "type": "EditorJsBlock",
                "content": {
                  "time": 0,
                  "version": "2.29.1",
                  "blocks": [
                    { "id": "h-1", "type": "header", "data": { "text": "Why workplace safety matters", "level": 2 } },
                    { "id": "p-1", "type": "paragraph", "data": { "text": "The rules protect you and your colleagues." } }
                  ]
                }
              }
            ]
          }
        ]
      }
    ]
  }'

const axios = require('axios');

const createCourse = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/course/create', {
      type: 'TextCourse',
      name: 'Workplace safety for new employees',
      description: 'An introductory safety course',
      tags: ['safety'],
      authors: [],
      modules: [
        {
          name: 'Module 1. Basics',
          description: '',
          status: 'Published',
          lessons: [
            {
              name: 'Lesson 1. Why workplace safety matters',
              description: '',
              status: 'Published',
              blocks: [
                {
                  type: 'EditorJsBlock',
                  content: {
                    time: 0,
                    version: '2.29.1',
                    blocks: [
                      { id: 'h-1', type: 'header', data: { text: 'Why workplace safety matters', level: 2 } },
                      { id: 'p-1', type: 'paragraph', data: { text: 'The rules protect you and your colleagues.' } }
                    ]
                  }
                }
              ]
            }
          ]
        }
      ]
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Course created:', response.data.payload);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

createCourse();

<?php

$url = 'https://api.exode.biz/saas/v2/course/create';
$data = [
  'type' => 'TextCourse',
  'name' => 'Workplace safety for new employees',
  'description' => 'An introductory safety course',
  'tags' => ['safety'],
  'authors' => [],
  'modules' => [
    [
      'name' => 'Module 1. Basics',
      'description' => '',
      'status' => 'Published',
      'lessons' => [
        [
          'name' => 'Lesson 1. Why workplace safety matters',
          'description' => '',
          'status' => 'Published',
          'blocks' => [
            [
              'type' => 'EditorJsBlock',
              'content' => [
                'time' => 0,
                'version' => '2.29.1',
                'blocks' => [
                  ['id' => 'h-1', 'type' => 'header', 'data' => ['text' => 'Why workplace safety matters', 'level' => 2]],
                  ['id' => 'p-1', 'type' => 'paragraph', 'data' => ['text' => 'The rules protect you and your colleagues.']]
                ]
              ]
            ]
          ]
        ]
      ]
    ]
  ]
];

$headers = [
  'Seller-Id: {{ sellerId }}',
  'School-Id: {{ schoolId }}',
  'Content-Type: application/json',
  'Authorization: Bearer YOUR_TOKEN'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
  $result = json_decode($response, true);
  echo "Course created: " . $result['payload']['id'] . "\n";
} else {
  echo "Error: HTTP $httpCode\n";
  echo $response;
}
?>

import requests

url = 'https://api.exode.biz/saas/v2/course/create'

data = {
  'type': 'TextCourse',
  'name': 'Workplace safety for new employees',
  'description': 'An introductory safety course',
  'tags': ['safety'],
  'authors': [],
  'modules': [
    {
      'name': 'Module 1. Basics',
      'description': '',
      'status': 'Published',
      'lessons': [
        {
          'name': 'Lesson 1. Why workplace safety matters',
          'description': '',
          'status': 'Published',
          'blocks': [
            {
              'type': 'EditorJsBlock',
              'content': {
                'time': 0,
                'version': '2.29.1',
                'blocks': [
                  { 'id': 'h-1', 'type': 'header', 'data': { 'text': 'Why workplace safety matters', 'level': 2 } },
                  { 'id': 'p-1', 'type': 'paragraph', 'data': { 'text': 'The rules protect you and your colleagues.' } }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

ВнутреннийБлок = Новый Структура;
ВнутреннийБлок.Вставить("id", "p-1");
ВнутреннийБлок.Вставить("type", "paragraph");
ВнутреннийБлок.Вставить("data", Новый Структура("text", "The rules protect you and your colleagues."));

СодержимоеБлока = Новый Структура;
СодержимоеБлока.Вставить("time", 0);
СодержимоеБлока.Вставить("version", "2.29.1");
СодержимоеБлока.Вставить("blocks", Новый Массив);
СодержимоеБлока.blocks.Добавить(ВнутреннийБлок);

Блок = Новый Структура;
Блок.Вставить("type", "EditorJsBlock");
Блок.Вставить("content", СодержимоеБлока);

Урок = Новый Структура;
Урок.Вставить("name", "Lesson 1. Why workplace safety matters");
Урок.Вставить("description", "");
Урок.Вставить("status", "Published");
Урок.Вставить("blocks", Новый Массив);
Урок.blocks.Добавить(Блок);

Модуль = Новый Структура;
Модуль.Вставить("name", "Module 1. Basics");
Модуль.Вставить("description", "");
Модуль.Вставить("status", "Published");
Модуль.Вставить("lessons", Новый Массив);
Модуль.lessons.Добавить(Урок);

Данные = Новый Структура;
Данные.Вставить("type", "TextCourse");
Данные.Вставить("name", "Workplace safety for new employees");
Данные.Вставить("description", "An introductory safety course");
Данные.Вставить("tags", Новый Массив);
Данные.tags.Добавить("safety");
Данные.Вставить("authors", Новый Массив);
Данные.Вставить("modules", Новый Массив);
Данные.modules.Добавить(Модуль);

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, Данные);
ТелоЗапроса = ЗаписьJSON.Закрыть();

Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 60, Новый OpenSSLSecureConnection);

Запрос = Новый HTTPЗапрос("/saas/v2/course/create");
Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}");
Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN");
Запрос.УстановитьТелоИзСтроки(ТелоЗапроса);

Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос);

Если Ответ.КодСостояния = 201 Тогда
    Сообщить("Course created");
Иначе
    Сообщить("Error: HTTP " + Ответ.КодСостояния);
    Сообщить(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 412,
    "createdAt": "2026-09-28T09:12:03.518Z",
    "updatedAt": "2026-09-28T09:12:03.941Z",
    "archivedAt": null,
    "type": "TextCourse",
    "productId": 1290,
    "buildStatus": "Ready",
    "name": "Workplace safety for new employees",
    "description": "An introductory safety course",
    "alias": null,
    "tags": [
      "safety"
    ],
    "seoTags": [],
    "image": {
      "main": ""
    },
    "promoVideo": null,
    "settings": {
      "editorAccessMode": "All",
      "curatorAccessMode": "All"
    },
    "order": 0,
    "isBundle": false
  }
}

{
  "code": 400,
  "success": false,
  "cause": "validation",
  "message": [
    "modules.0.lessons.0.name must be shorter than or equal to 120 characters"
  ],
  "error": "Bad Request"
}

{
  "code": 402,
  "success": false,
  "cause": "SaasLimitReached",
  "message": "School plan limit reached: maxActiveProducts (10/10)",
  "error": "School plan limit reached: maxActiveProducts (10/10)",
  "data": {
    "max": 10,
    "current": 10,
    "feature": "maxActiveProducts"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "AliasAlreadyBusy",
  "message": "Этот адрес уже занят",
  "error": "Этот адрес уже занят"
}

{
  "code": 400,
  "success": false,
  "cause": "CertificateTemplateRequired",
  "message": "Certificate template is required",
  "error": "Certificate template is required"
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "message": "Forbidden seller resource - permissions CourseManage",
  "error": "Forbidden seller resource - permissions CourseManage"
}

Errors

HTTP	`cause`	When it happens
400	`validation`	The body failed validation: type, length, enum, limits (50 modules, 100 lessons per module, 100 blocks per lesson). The field path is in `message`
400	`InvalidAlias`	`alias` contains invalid characters or consists of digits only
400	`AliasAlreadyBusy`	`alias` is already taken by another course
400	`CertificateTemplateRequired`	The certificate is enabled but `templateId` is missing
400	`CertificateTemplateNotAvailable`	The certificate template is not available to the school
400	`BundleGroupAlreadyUsed`	The same group appears in several `bundleCourses` rows
400	`BundleCourseSellerMismatch`	A course or group from `bundleCourses` belongs to another school
401	`Forbidden`	The key lacks the `CourseManage` permission, or the method is called for a non-school seller (`Allowed only for school`)
402	`SaasLimitReached`	The plan limit on active products is reached. `data` holds `feature`, `current`, `max`

The InvalidAlias and AliasAlreadyBusy messages are currently returned in Russian — rely on cause.

Update a course — change course fields
Get a course — the full course object by ID
Course enrollment — grant access through a course group
The course object — response fields

Permission requirements

Requires token authentication and the “Course Management” permission (CourseManage). The method is available to schools only.

Updated: 2026-09-28 05:04 UTC

Working with the API

Users

Staff (HR)

Groups

Courses

Access and sales

Reports and exports

Custom fields

Forms

Missing a method?

All objects

Request headers

Request parameters

Course

Modules and lessons

Content blocks

Response fields

Errors

Permission requirements

​Request headers

​Request parameters

​Course

​Modules and lessons

​Content blocks

​Response fields

​Errors

​Related sections

​Permission requirements

Request headers

Request parameters

Course

Modules and lessons

Content blocks

Response fields

Errors

Related sections

Permission requirements