cohort_memberships.create

Put an applicant into a cohort

Request: POST/api/v1/organizations/{organizationSlug}/cohort-memberships
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: cohort_memberships_create
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Starts a stint: records that this applicant is in this cohort from now on. An applicant may be in several cohorts at once, so this adds one rather than replacing what they are already in; asking again for a cohort they are already in is refused with 409 rather than opening a second overlapping stint. The person must already be an applicant member of the organization — to bring somebody in from outside, invite them with `organization_invitations.create` and name the `cohortId` there. Owners and admins may call it.

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

cohortId: string, required
memberEmail: string or string, required

Response

applicantEmail: string, required
cohortId: string, required
departureReason: one of: completed, placed, withdrew, removed or null, required
id: string, required
joinedAt: string, required
leftAt: string or null, required
note: string or null, required

Examples

Place a student in the spring intake

Place a student in the spring intake — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/cohort-memberships \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "memberEmail": "student@northside.example",
  "cohortId": "coh_12"
}'

Place a student in the spring intake — response

{
  "id": "cm_87",
  "cohortId": "coh_12",
  "applicantEmail": "student@northside.example",
  "joinedAt": "2026-01-06T12:00:00.000Z",
  "leftAt": null,
  "departureReason": null,
  "note": null
}