> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidoc.dreamclass.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidoc.dreamclass.io/_mcp/server.

# CreateClass

POST https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/{schoolPeriodId}/classes/create
Content-Type: application/json

Create a class in a school period.

Input variables

- schoolPeriodId: id of the school period. Check the GetSchoolPeriods call

Two kinds of class:

- **Single-subject**: send its course as `courseId` (as in the example). If you leave `name` empty the class takes the course's name.
- **Multi-subject**: send its courses as `courseIds` instead, e.g. `"courseIds": [12, 13]`.

Send one or the other, not both. Course ids come from GetSchoolCourses (or CreateCourse) and must all belong to your school. The school period must be one of your school's.

Accepted fields: `name`, `code`, `description`, `startDate`, `endDate`, `capacity`, `courseId` / `courseIds`. Anything else is ignored.

Returns the class in the same shape as GetPeriodClasses; its class courses then appear in GetPeriodClassCourses. Fires the CLASS_CREATED webhook.

Reference: https://apidoc.dreamclass.io/dream-class-api/curriculum/create-class

## Servers

- `https://api.dreamclass.io` (https://api.dreamclass.io, default)
- `https://your-webhook-url` (https://your-webhook-url)

## Request

### Path parameters

- `schoolPeriodId` (string, required)

### Headers

- `dreamclass-secret-key` (string, optional) — Your DreamClass API key. Required on every request. Find it in the DreamClass app under Settings > Integrations.
- `tenant` (string, optional) — Your tenant code: the DreamClass subdomain you sign in at (for https://myaccount.dreamclass.io it is "myaccount"), or your full white-labelled domain. Required on every request.
- `schoolCode` (string, optional) — Your school code. Required on every request. Find it in the DreamClass app under Settings > Integrations.

### Body (application/json)

This endpoint expects an object.

- `name` (string, required)
- `code` (string, required)
- `description` (string, required)
- `startDate` (date, required)
- `endDate` (date, required)
- `capacity` (integer, required)
- `courseId` (integer, required)

## Response

### 200

OK

- `name` (string, required)
- `id` (integer, required)
- `description` (string, required)
- `code` (string, required)
- `endDate` (date, required)
- `startDate` (date, required)
- `schoolTags` (list of any, required)
- `capacity` (integer, required)

## Examples

**Request**

```json
{
  "name": "Mathematics A1",
  "code": "MATH-A1",
  "description": "Morning group",
  "startDate": "2026-09-14",
  "endDate": "2027-06-15",
  "capacity": 20,
  "courseId": 12
}
```

**Response**

```json
{
  "name": "Mathematics A1",
  "id": 31,
  "description": "Morning group",
  "code": "MATH-A1",
  "endDate": "2027-06-15",
  "startDate": "2026-09-14",
  "schoolTags": [],
  "capacity": 20
}
```

**SDK Code**

```python CreateClass
import requests

url = "https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create"

payload = {
    "name": "Mathematics A1",
    "code": "MATH-A1",
    "description": "Morning group",
    "startDate": "2026-09-14",
    "endDate": "2027-06-15",
    "capacity": 20,
    "courseId": 12
}
headers = {
    "dreamclass-secret-key": "{{apiKey}}",
    "tenant": "{{tenant}}",
    "schoolCode": "{{schoolCode}}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript CreateClass
const url = 'https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create';
const options = {
  method: 'POST',
  headers: {
    'dreamclass-secret-key': '{{apiKey}}',
    tenant: '{{tenant}}',
    schoolCode: '{{schoolCode}}',
    'Content-Type': 'application/json'
  },
  body: '{"name":"Mathematics A1","code":"MATH-A1","description":"Morning group","startDate":"2026-09-14","endDate":"2027-06-15","capacity":20,"courseId":12}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go CreateClass
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create"

	payload := strings.NewReader("{\n  \"name\": \"Mathematics A1\",\n  \"code\": \"MATH-A1\",\n  \"description\": \"Morning group\",\n  \"startDate\": \"2026-09-14\",\n  \"endDate\": \"2027-06-15\",\n  \"capacity\": 20,\n  \"courseId\": 12\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("dreamclass-secret-key", "{{apiKey}}")
	req.Header.Add("tenant", "{{tenant}}")
	req.Header.Add("schoolCode", "{{schoolCode}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby CreateClass
require 'uri'
require 'net/http'

url = URI("https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["dreamclass-secret-key"] = '{{apiKey}}'
request["tenant"] = '{{tenant}}'
request["schoolCode"] = '{{schoolCode}}'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Mathematics A1\",\n  \"code\": \"MATH-A1\",\n  \"description\": \"Morning group\",\n  \"startDate\": \"2026-09-14\",\n  \"endDate\": \"2027-06-15\",\n  \"capacity\": 20,\n  \"courseId\": 12\n}"

response = http.request(request)
puts response.read_body
```

```java CreateClass
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create")
  .header("dreamclass-secret-key", "{{apiKey}}")
  .header("tenant", "{{tenant}}")
  .header("schoolCode", "{{schoolCode}}")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Mathematics A1\",\n  \"code\": \"MATH-A1\",\n  \"description\": \"Morning group\",\n  \"startDate\": \"2026-09-14\",\n  \"endDate\": \"2027-06-15\",\n  \"capacity\": 20,\n  \"courseId\": 12\n}")
  .asString();
```

```php CreateClass
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create', [
  'body' => '{
  "name": "Mathematics A1",
  "code": "MATH-A1",
  "description": "Morning group",
  "startDate": "2026-09-14",
  "endDate": "2027-06-15",
  "capacity": 20,
  "courseId": 12
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'dreamclass-secret-key' => '{{apiKey}}',
    'schoolCode' => '{{schoolCode}}',
    'tenant' => '{{tenant}}',
  ],
]);

echo $response->getBody();
```

```csharp CreateClass
using RestSharp;

var client = new RestClient("https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create");
var request = new RestRequest(Method.POST);
request.AddHeader("dreamclass-secret-key", "{{apiKey}}");
request.AddHeader("tenant", "{{tenant}}");
request.AddHeader("schoolCode", "{{schoolCode}}");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"name\": \"Mathematics A1\",\n  \"code\": \"MATH-A1\",\n  \"description\": \"Morning group\",\n  \"startDate\": \"2026-09-14\",\n  \"endDate\": \"2027-06-15\",\n  \"capacity\": 20,\n  \"courseId\": 12\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift CreateClass
import Foundation

let headers = [
  "dreamclass-secret-key": "{{apiKey}}",
  "tenant": "{{tenant}}",
  "schoolCode": "{{schoolCode}}",
  "Content-Type": "application/json"
]
let parameters = [
  "name": "Mathematics A1",
  "code": "MATH-A1",
  "description": "Morning group",
  "startDate": "2026-09-14",
  "endDate": "2027-06-15",
  "capacity": 20,
  "courseId": 12
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.dreamclass.io/dreamclassapi/v1/curriculum/schoolperiod/schoolPeriodId/classes/create")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```