---
title: "Create Course Offering"
method: POST
path: "/v1/installs/{installSid}/courseOfferings"
tags: ["Course Offering"]
---

# Create Course Offering

`POST /v1/installs/{installSid}/courseOfferings`

## Request

- Base URL: `https://api.smarterproctoring.com`
- URL: `https://api.smarterproctoring.com/v1/installs/{installSid}/courseOfferings`
- Auth: API key in header `token`

Creates a new course offering (e.g., semester, term, or academic period) under the specified application install.<br/><br/>The `matchStrings` field is used to automatically match incoming courses from the LMS to this offering based on text patterns.

## Path parameters

- `installSid` string, required: Unique SID of the application install. Pattern: `AI` + 32 hex chars.

## Request body

- CourseOffering: Payload for creating a new course offering
  - `title` string, required: Human-readable title for the course offering (e.g., semester or term name).
  - `matchStrings` string, required: Comma-separated list of text patterns used to automatically match incoming LMS courses to this offering.
  - `startDate` string, nullable: Start Date
  - `endDate` string, nullable: End Date

## Response `200`

Successful

- CourseOfferingResponse
  - `sid` string, nullable: Course offering SID
  - `lastActivityDate` string, nullable: Last activity date
  - `title` string, nullable: Offering title
  - `matchStrings` string[], nullable: Match strings for auto-matching
  - `startDate` string, nullable: Start date
  - `endDate` string, nullable: End date
  - `createdDate` string, nullable: Created date
  - `editDate` string, nullable: Last modified date

---

[API](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2.md) - [All operations](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api-2/revisions/7199a3921c9d?raw)
