post_candidate
Submit a candidate via the Ingestion API for partner integrations. Use for external system integrations, not internal recruiter workflows.
Instructions
Submit a candidate via the Ingestion API (partner integration). Write operation.
For internal candidate creation (as recruiter/admin), use create_candidate and create_application instead. This is the partner/integration endpoint.
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": {
"first_name": "<first_name>",
"last_name": "<last_name>",
"email": "<email>"
},
"name": "post_candidate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Candidate's email address | ||
| phone | No | Candidate's phone number | |
| job_id | No | Job to apply to — retrieve_ingestion_jobs to find | |
| resume | No | Resume content or URL | |
| source | No | Source name (free text) | |
| prospect | No | True to create as prospect instead of applicant | |
| last_name | Yes | Candidate's last name | |
| first_name | Yes | Candidate's first name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |