/jobs/{jobId}/candidates – insert

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
email 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"
  }
}