Record what an employer did
freeapply_record_outcomeRecord employer responses to job applications—acknowledgements, interviews, rejections, offers—from Gmail emails or manual updates, and update each job's outcome status in FreeApply.
Instructions
Records what an employer did with an application (your side, e.g. applied or skipped: freeapply_update_job). Use: for each employer email found in a reply check, between freeapply_check_replies start and finish, and when the user tells you about a call or corrects an outcome. Not for your own steps. Behavior: with an email (gmail_message_id): stores it; raises the job's outcome only if this email ranks higher than the current one (an interview outranks an acknowledgement); the same gmail_message_id again stores nothing new. Without an email: sets the outcome exactly, whatever its rank. The email fields fill the dashboard's Replies tab. Returns: with an email {recorded (false: recorded before), kind, job_id, outcome (the job's, afterwards)}, job_id and outcome null without job_id; without one {job_id, outcome}. Errors: an unknown job_id; no job_id and no email; an empty outcome with an email.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"outcome": "<outcome>"
},
"name": "freeapply_record_outcome"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No | From the reply-check plan or freeapply_list_jobs. Required without an email; with one optional, but without it no outcome changes. | |
| sender | No | Email: sender address. | |
| company | No | Email: the employer that sent it. | |
| outcome | Yes | What the employer did: acknowledged (automatic 'we received your application' email), replied (a person replied), assessment (test, assignment or screening questionnaire), interview (interview requested or scheduled), rejected (rejection), offer (offer), withdrawn (candidate withdrew); or "" to clear it (without an email only). | |
| subject | No | Email: subject line. | |
| summary | No | Email: what it says, one sentence of at most 20 words, no personal data beyond what is needed. | |
| mail_action | No | Email: what you did with it in Gmail: starred, labeled:<name>, starred+labeled:<name> or none. | |
| received_at | No | Email: when it arrived (ISO 8601). | |
| gmail_thread_id | No | Email: Gmail thread id. | |
| gmail_message_id | No | The employer email's Gmail message id. |