cohorts.create

Create a cohort

Request: POST/api/v1/organizations/{organizationSlug}/cohorts
Scope required: organizations:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on an organization, and names it in the path.
MCP tool: cohorts_create
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Creates a cohort — an intake, a class, a programme — that applicants can then be placed into with `cohort_memberships.create`, and that the roster and the insights dashboard can be narrowed to. Names are unique within an organization, so a name somebody already used is refused with 409. Owners and admins may call it. Send an `Idempotency-Key` header if a retry must not create a second cohort.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
organizationSlug	path	Required	string

Request body

name: string, required

Response

archivedAt: string or null, required
createdAt: string, required
id: string, required
name: string, required

Examples

Open the spring intake

Open the spring intake — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/cohorts \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring 2026 intake"
}'

Open the spring intake — response

{
  "id": "coh_12",
  "name": "Spring 2026 intake",
  "archivedAt": null,
  "createdAt": "2026-01-06T12:00:00.000Z"
}