create_candidate
Create a candidate record by supplying a first name; optionally add contact details, organization, and custom fields.
Instructions
Create a candidate via POST /v1/candidates.
first_name is the only required field. current_organization_slug
links the candidate to an existing company record; current_organization
is the free-text fallback.
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>"
},
"name": "create_candidate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| first_name | Yes | ||
| last_name | No | ||
| No | |||
| contact_number | No | ||
| current_organization | No | ||
| current_organization_slug | No | ||
| current_status | No | ||
| position | No | ||
| city | No | ||
| state | No | ||
| country | No | ||
| salary_expectation | No | ||
| notice_period | No | ||
| available_from | No | ||
| No | |||
| owner_id | No | ||
| custom_fields | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| id | Yes | ||
| title | No | ||
| url | No |