coach_notes.create

Leave feedback on an application

Request

POST/api/v1/applications/{applicationId}/coach-notes

Scope required

coach_notes:write

Effect

Changes data. Send an Idempotency-Key if you might retry it.

Acts on

Serves an account’s own data and, where shared, an organization’s.

MCP tool

coach_notes_create

Environment

Live and sandbox alike.

Request body

JSON.

What it does

Writes a note on one application of a board an applicant has shared with your organization. Every note is written to be read by the applicant it is about — there is no private staff channel here — so write it as you would say it to them. Only staff of a sharing organization may create one; an applicant reading their own card is refused. The organization and the share the note belongs to are taken from your own access rather than from the request, so a note cannot be filed under somebody else's organization. Find the application through `organization_shares.list` and then `applications.list`, and read the thread back with `coach_notes.list_for_application`.

Parameters

Request body

body

string, required

Response

applicationId

string, required

authorDisplayName

string or null, required

body

string, required

createdAt

string, required

id

string, required

organization

object, required

name

string, required

slug

string, required

updatedAt

string, required

Examples

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/applications/app_123/coach-notes \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "Ask them about the take-home before Thursday."
}'

{
  "id": "note_54",
  "applicationId": "app_123",
  "body": "Ask them about the take-home before Thursday.",
  "authorDisplayName": "Dana Reyes",
  "organization": {
    "slug": "northside-career-center",
    "name": "Northside Career Center"
  },
  "createdAt": "2026-02-11T17:05:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}

Related operations