Description
Enables you to create new candidates which will be assigned to a Job. This operation requires passing an instance of the Candidate object as part of the POST request.
If you want to assign candidates to Talent Pool, please see the /candidates – instert endpoint for more details.
Request
POST https://api.smartrecruiters.com/jobs/{jobId}/candidates
Path Parameters
name | type | description |
---|---|---|
jobId | string | Id of a Job to which you want to assign a candidate when it’s created; e.g. 78d3ef91-8868-4ff3-b35d-9debf9d6f31f; If you want to assign a Candidate to Talent Pool, please use the /candidates – insert endpoint for more details |
Query Parameters
n/a
Request Body
Candidate object needs to be passed as a part of the request body. Required fields are:
name | type | description |
---|---|---|
firstName | string | first name of a Candidate |
lastName | string | last name of a Candidate |
string | email address of a Candidate |
Response Body
Instance of the Candidate object.
Example request
curl -i -H "X-SmartToken:abc123" -H "Content-Type: application/json;charset=utf-8" -d @body.json -X POST https://api.smartrecruiters.com/jobs/ae9c49e2-1adc-4cbc-8ea6-bc4b50117f5a/candidates
Example request body
{ "firstName": "Jakub", "lastName": "Kowalski", "email": "kowalski@test.gmail.com", "phoneNumber": "00112345698795", "location": { "city": "Cracow", "country": "Poland", "region": "Lesser Poland District" }, "web": { "skype": "j.kowalski", "linkedin": "https://www.linkedin.com/in/jkowalski", "facebook": "https://www.facebook.com/jkowalski", "twitter": "jkowalski", "website": "http://jkowalski.com" }, "tags": [ "Developer","Architect" ], "education": [ { "institution": "Politechnika Krakowska im. Tadeusza Kościuszki", "degree": "Master of Science", "major": "Applied Computer Science", "current": true, "startDate": "2004", "endDate": "2010" } ], "experience": [ { "title": "Technical Product Manager, Platform and Integrations", "company": "SmartRecruiters", "current": true, "startDate": "2014-01", "endDate": "2013-12" }, { "title": "Project Manager", "company": "Lumesse", "current": false, "startDate": "2013-10", "endDate": "2013-12" }, { "title": "Manager Client Technical Services TalentLink", "company": "Lumesse", "current": false, "startDate": "2012-10", "endDate": "2013-08", "description": "- Manage two groups of Front-End Developers and Technical Consultants (14 people) to deliver multiple international projects (~80 / month) to end customers in scope, timescales and highest possible quality with constantly competing resources and priorities\n- Lead a corporate project of building automated data migrations to successfully transfer 300+ customers from legacy products to a new platform\n- Implement front-end good practices, tools and projects\n- Rebuild internal and external processes to improve project delivery efficiency and team flexibility\n- Coordinate a merge, training and knowledge transfer of two teams sitting in different international locations while keeping constant, high level service delivery\n- Recruit talents, manage staff: people development, performance management, disciplinary procedures\n\nSkillset: Project Management, People Management, Problem Solving, Process Optimisation, Conflict Resolution, Recruitment" } ] } |
Example response
{ "id": "87d3665e-afe8-4854-bba5-add5d0a0e952", "firstName": "Jakub", "lastName": "Kowalski", "email": "kowalski@test.gmail.com", "location": { "city": "Cracow", "country": "Poland", "region": "Lesser Poland District" }, "web": { "skype": "j.kowalski", "linkedin": "https://www.linkedin.com/in/jkowalski", "facebook": "https://www.facebook.com/jkowalski", "twitter": "jkowalski", "website": "http://jkowalski.com" }, "createdOn": "2014-11-03T16:50:23.025Z", "updatedOn": "2014-11-05T11:03:31.860Z", "tags": [ "Architect", "Developer" ], "education": [ { "institution": "Politechnika Krakowska im. Tadeusza Kościuszki", "degree": "Master of Science", "major": "Applied Computer Science", "current": true, "startDate": "2004", "endDate": "2010" } ], "experience": [ { "title": "Technical Product Manager, Platform and Integrations", "company": "SmartRecruiters", "current": true, "startDate": "2014-01", "endDate": "2013-12" }, { "title": "Project Manager", "company": "Lumesse", "current": false, "startDate": "2013-10", "endDate": "2013-12" }, { "title": "Manager Client Technical Services TalentLink", "company": "Lumesse", "current": false, "startDate": "2012-10", "endDate": "2013-08", "description": "- Manage two groups of Front-End Developers and Technical Consultants (14 people) to deliver multiple international projects (~80 / month) to end customers in scope, timescales and highest possible quality with constantly competing resources and priorities\n- Lead a corporate project of building automated data migrations to successfully transfer 300+ customers from legacy products to a new platform\n- Implement front-end good practices, tools and projects\n- Rebuild internal and external processes to improve project delivery efficiency and team flexibility\n- Coordinate a merge, training and knowledge transfer of two teams sitting in different international locations while keeping constant, high level service delivery\n- Recruit talents, manage staff: people development, performance management, disciplinary procedures\n\nSkillset: Project Management, People Management, Problem Solving, Process Optimisation, Conflict Resolution, Recruitment" } ], "primaryAssignment": { "job": { "id": "ae9c49e2-1adc-4cbc-8ea6-bc4b50117f5a", "title": "Senior Ruby Game Developer", "actions": { "details": { "url": "https://api.smartrecruiters.com/jobs/ae9c49e2-1adc-4cbc-8ea6-bc4b50117f5a", "method": "GET" } } }, "status": "LEAD", "source": "Import" } } |