create_candidate
Create a candidate in Kula with required first name and either email or LinkedIn profile. Optionally add to a job pipeline, tags, skills, and custom fields.
Instructions
Create a new candidate in Kula. At least one of email or linkedin_url (in social_urls) is required. Optionally link to a job pipeline via job_id and job_stage_id. Returns the created candidate object.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| first_name | Yes | Candidate's first name (required) | |
| last_name | No | Candidate's last name | |
| No | Candidate's email address. Required unless linkedin_url is provided. | ||
| phone_number | No | Candidate's phone number | |
| tags | No | Comma-separated tag names to attach | |
| skills | No | Comma-separated skill names to attach | |
| job_id | No | Job ID to add this candidate to a pipeline | |
| job_stage_id | No | Stage ID within the job pipeline (use with job_id) | |
| candidate_source_id | No | Source ID — get IDs from list_sources | |
| credited_to_user_id | No | User ID to credit for this candidate | |
| social_urls | No | Social profile URLs. Include linkedin here if not providing email. | |
| location | No | Candidate location using places IDs | |
| additional_info | No | Custom field values as key-value pairs |