/candidates – insert

Description

Enables you to create new candidates which will be assigned to a Talent Pool. This operation requires passing an instance of the Candidate object as part of the POST request.

If you want to assign candidates to a Job, please see the /jobs/{jobId}/candidates – insert endpoint for more details.

Request

POST https://api.smartrecruiters.com/candidates

Path Parameters

n/a

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/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-03T16:50:24.019Z",
  "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"
    }
  ]
}