Courses Overview

The Courses API lets you programmatically import and manage online courses, lesson content, categories, and membership products on the HoopAI Platform. Use it to migrate existing course libraries into the platform, automate content updates, and keep your membership product catalog in sync with external systems. The API supports rich course structures including nested categories, sub-categories, individual lesson posts, attached materials, and instructor details — giving you full control over how courses are organized and delivered to your members.

Base URL

https://services.leadconnectorhq.com

Authentication

All requests require a Bearer token in the Authorization header. Obtain tokens through the OAuth 2.0 flow.

Authorization: Bearer <access_token>
Version: 2021-07-28

The Version header is required on every request and must be set to 2021-07-28.

OAuth scopes

Scope	Access
`courses.readonly`	Read course data, categories, and lesson content
`courses.write`	Full read and write access including import and update operations

Quick start

Import a course into a location:

curl --request POST \
  --url 'https://services.leadconnectorhq.com/courses/courses-exporter/public/import' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Version: 2021-07-28' \
  --header 'Content-Type: application/json' \
  --data '{
    "locationId": "YOUR_LOCATION_ID",
    "products": [
      {
        "title": "Intro to Basketball Analytics",
        "description": "A foundational course on basketball data and analytics.",
        "categories": [
          {
            "title": "Module 1 — Fundamentals",
            "visibility": "published",
            "posts": [
              {
                "title": "Lesson 1 — Reading the Box Score",
                "visibility": "published",
                "contentType": "video",
                "description": "Learn how to interpret standard box score statistics."
              }
            ]
          }
        ]
      }
    ]
  }'

Endpoints

Method	Path	Description
`POST`	`/courses/courses-exporter/public/import`	Import one or more courses into a location

Course structure

When importing courses, the request body follows a nested structure:

Field	Type	Description
`locationId`	string	The location to import courses into
`userId`	string	Optional. The user performing the import
`products`	array	Array of course product objects
`products[].title`	string	Course title
`products[].description`	string	Course description
`products[].imageUrl`	string	Course thumbnail URL
`products[].categories`	array	Top-level categories (modules)
`products[].instructorDetails`	object	Instructor name and description
`categories[].title`	string	Category (module) title
`categories[].visibility`	string	`published` or `draft`
`categories[].posts`	array	Lessons within this category
`categories[].subCategories`	array	Nested sub-categories
`posts[].title`	string	Lesson title
`posts[].contentType`	string	`video`, `assignment`, or `quiz`
`posts[].visibility`	string	`published` or `draft`
`posts[].description`	string	Lesson description
`posts[].bucketVideoUrl`	string	Video URL for video lessons
`posts[].postMaterials`	array	Downloadable materials attached to the lesson

OAuth 2.0 overview — how to obtain and refresh access tokens
Contacts API — manage the members enrolled in your courses
Payments API — sell course access through products and subscriptions

Funnels

Forms

Surveys

Blogs

Media Library

Courses

Base URL

Authentication

OAuth scopes

Quick start

Endpoints

Course structure

​Base URL

​Authentication

​OAuth scopes

​Quick start

​Endpoints

​Course structure

​Related

Base URL

Authentication

OAuth scopes

Quick start

Endpoints

Course structure

Related