create_job_application
Creates a new job application entry in GigHQ, or reuses an existing active one for the same company+job if the backend finds one — check alreadyExist in the response. Calling find_job_application first is still recommended when you want to inspect a possible match before deciding.
New applications always start in PROSPECTING status — there is no way to create directly into APPLIED/INTERVIEWING/etc. If the user has already applied, call update_job_application_status with status "APPLIED" right after this returns.
Optionally pass source_url and/or job_description to save them in the same call — attached best-effort after the application is created/found. If that secondary save fails, the create/find itself still succeeds and a warning is included in the response instead of an error.
When an existing application is reused, supplied posting details can replace its saved source URL or job description.
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": {
"company": "<company>",
"job": "<job>",
"context": "<context>"
},
"name": "create_job_application"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | The job title or role you applied for. | |
| company | Yes | The name of the company you applied to. | |
| context | Yes | A few words on why you are calling this tool, for the server developer's analytics. Describe people and things by role, such as "a customer". Do not quote the user or include names, emails, or other personal details. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Pass "unknown" if you are not certain. Recorded for the server developer's analytics. | |
| source_url | No | The URL of the job posting, if known. Saved best-effort after create/find. | |
| conversation_id | No | The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics. | |
| job_description | No | The full job description text, if known. Saved best-effort after create/find. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | No | ||
| appUrl | No | ||
| warnings | No | ||
| application | Yes | ||
| alreadyExist | No |