Apply to Job
getmattered_applyDestructive
Applies to one job by job_match_id or job_url, or to up to 10 jobs under one yes by job_match_ids, on the employer's own hiring system; for a job-board link, GetMattered first looks for the employer's own posting. mode "auto" submits, "review" holds for approval, and no mode follows the account setting. A sent application cannot be withdrawn. When GetMattered cannot apply, nothing is sent, and the answer says why and whether the job stays on the user's GetMattered board.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "getmattered_apply"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | "auto" submits with no review step. "review" holds the prepared application for the user's approval. Left out, the user's account setting decides. Applies to this application only. | |
| job_url | No | Link to any job posting to apply to. Either this or job_match_id, which identifies a job from getmattered_get_matches. | |
| job_match_id | No | The job_match_id of a match from getmattered_get_matches (e.g. 48213). Either this or job_url. | |
| job_match_ids | No | Up to 10 job_match_ids from getmattered_get_matches, applied to under one confirmation (e.g. [48213, 48214]). Each job gets its own result. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host of the job_url, when one was given. | |
| kept | Yes | True when nothing was sent and the job stays on the user's GetMattered board, at trackingUrl. GetMattered tells the user once it can send it, unless reason is account_only_board. | |
| jobUrl | Yes | ||
| notice | No | Present when the confirmation form got no answer: the application is held for approval and nothing was sent. | |
| reason | Yes | Null when a new application started. unsupported_host: GetMattered does not submit on that hiring system. posting_not_found: the employer has no posting at that link. import_failed: the posting could not be read or saved. no_employer_posting: the job-board posting was read, and GetMattered found no employer posting it sends on. account_only_board: the employer takes this job on a job board that needs that board's own account (Y Combinator's Work at a Startup), where GetMattered does not send. already_applied: this job already has an application. Nothing is sent for any reason. kept says whether the job stays on the user's GetMattered board. | |
| status | Yes | Our own record, which is not proof the employer received it. | |
| company | Yes | ||
| outcome | Yes | started: a new application; already_in_progress: this job already had one (alreadyExisted); not_confirmed: the user declined, nothing was sent; not_applied: nothing was sent, see reason and userAction; batch: a job_match_ids call, with one entry per job in results. | |
| results | Yes | One entry per job of a job_match_ids call, in the order given. Empty when one job was named. | |
| jobTitle | Yes | ||
| setupStep | No | Present while account setup is open: the first setup step. | |
| jobMatchId | Yes | ||
| userAction | Yes | What the user can do next, in words ready for the user. Null when a new application started. | |
| trackingUrl | Yes | ||
| reasonDetail | No | Why the posting could not be read, in words ready for the user. Present with import_failed. | |
| recordedMode | Yes | ||
| applicationId | Yes | The application to follow with getmattered_get_applications. Null only when nothing was started. | |
| requestedMode | Yes | ||
| alreadyExisted | Yes | True when this job already had an application. The answer holds that application, and no second one starts. | |
| employerConfirmed | Yes | True ONLY when the employer sent a receipt or showed its confirmation page. False right after an apply. | |
| preparationStatus | Yes | ||
| preparedUnderFreeWatch | Yes |