applications.create

Add an application to a board

Request

POST/api/v1/boards/{boardId}/applications

Scope required

applications: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

applications_create

Environment

Live and sandbox alike.

Request body

JSON.

What it does

Files a new application on the named board and answers 201 with the whole card. `job.title` is required, and the company is named either by `company.name` (found or created under that name) or by `company.id` from `companies.list`. `status` defaults to `applied`, which opens the card's status history — use `applications.move` afterwards rather than filing the card in the column you eventually want. Everything else has a sensible default and can be filled in later with `applications.update`. Send an `Idempotency-Key` header if a retry must not file the application twice.

Parameters

Request body

applicationDate

string or null, optional

applicationLink

string or null, optional

company

object, required

id

any, optional

industry

one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, optional

linkedin

string or null, optional

name

string, optional

size

one of: tiny, small, medium, large, massive or null, optional

type

one of: government_agency, non_profit, private, public or null, optional

website

string or null, optional

job

object, required

compensation

object, optional

currency

string, optional

payAmount

number or null, optional

payFrequency

one of: hourly, weekly, biweekly, monthly, annually, other, optional

salaryRangeMax

number or null, optional

salaryRangeMin

number or null, optional

description

string or null, optional

location

object, optional

city

string or null, optional

country

string or null, optional

postalCode

string or null, optional

state

string or null, optional

street

string or null, optional

street2

string or null, optional

title

string, optional

workMode

one of: remote, hybrid, onsite, optional

workType

one of: full_time, part_time, contract, temporary, internship, optional

notes

string or null, optional

resumeId

string or null, optional

source

string or null, optional

status

one of: saved, applied, interviewing, offer, rejected, accepted, archived, optional

Response

applicationDate

string or null, required

applicationLink

string or null, required

boardId

string, required

company

object, required

id

string, required

industry

one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, required

linkedin

string or null, required

name

string, required

size

one of: tiny, small, medium, large, massive or null, required

type

one of: government_agency, non_profit, private, public or null, required

website

string or null, required

counts

object, required

coachNotes

integer, required

interviews

integer, required

createdAt

string, required

creationMethod

one of: form, csv_import, plugin, api, required

id

string, required

isAutoRetired

boolean, required

job

object, required

compensation

object or null, required

description

string or null, required

location

object or null, required

title

string, required

workMode

one of: remote, hybrid, onsite, required

workType

one of: full_time, part_time, contract, temporary, internship, required

notes

string or null, required

resume

object or null, required

source

string or null, required

status

one of: saved, applied, interviewing, offer, rejected, accepted, archived, required

statusChangedAt

string or null, required

updatedAt

string, required

Examples

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/boards/brd_7/applications \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "job": {
    "title": "Staff Engineer",
    "workMode": "remote"
  },
  "company": {
    "name": "Northwind",
    "industry": "software"
  },
  "source": "LinkedIn"
}'

{
  "id": "app_123",
  "boardId": "brd_7",
  "status": "applied",
  "statusChangedAt": "2026-02-11T17:05:00.000Z",
  "applicationDate": "2026-02-11T00:00:00.000Z",
  "applicationLink": "https://example.com/jobs/staff-engineer",
  "source": "LinkedIn",
  "notes": "Referred by a former colleague.",
  "isAutoRetired": false,
  "creationMethod": "form",
  "job": {
    "title": "Staff Engineer",
    "description": "Own the billing platform.",
    "workMode": "remote",
    "workType": "full_time",
    "location": {
      "street": null,
      "street2": null,
      "city": "Austin",
      "state": "Texas",
      "country": "United States",
      "postalCode": null
    },
    "compensation": {
      "payAmount": 195000,
      "payFrequency": "annually",
      "currency": "USD",
      "salaryRangeMin": null,
      "salaryRangeMax": null
    }
  },
  "company": {
    "id": "co_42",
    "name": "Northwind",
    "industry": "software",
    "size": "medium",
    "type": "private",
    "website": "https://northwind.example",
    "linkedin": null
  },
  "resume": null,
  "counts": {
    "interviews": 1,
    "coachNotes": 0
  },
  "createdAt": "2026-02-11T17:05:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}

Related operations