organizations.create

Create an organization

Request: POST/api/v1/organizations
Scope required: organizations:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on the account’s own job search.
MCP tool: organizations_create
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Creates an organization with the calling account as its owner, and answers with the slug every other organization operation is addressed by. The slug is derived from the name rather than chosen: a name that yields nothing usable, or one somebody else already holds, is resolved with a suffix instead of being refused, so read the slug back from this response rather than guessing it. A credential restricted to one organization may not create another. The slug it answers with is what `organizations.get` and every other organization operation take.

Request body

name: string, required
type: one of: career_coach, bootcamp, college, trade_school, government, other, required
website: string, optional

Response

createdAt: string, required
id: string, required
name: string, required
slug: string, required
type: one of: career_coach, bootcamp, college, trade_school, government, other, required
updatedAt: string, required
website: string or null, required

Examples

Open a career centre

Open a career centre — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/organizations \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Northside Career Center",
  "type": "college",
  "website": "https://careers.northside.example"
}'

Open a career centre — response

{
  "id": "org_5c1f9a7e-2b64-4f0b-9c2a-7d8e1f3a4b5c",
  "slug": "northside-career-center",
  "name": "Northside Career Center",
  "type": "college",
  "website": "https://careers.northside.example",
  "createdAt": "2026-01-04T09:30:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}