v1

latestOpenAPI 3.1.02026-07-249097.5 KB

/candidates

Manually add candidate to your account. Watch out when testing the endpoint here! It will create a candidate in your company!

post/c/{company_id}/candidates

Path parameters

company_idinteger required

Company ID. A company subdomain can also be used.

Headers

Content-Typestring

Request body

offersinteger[]

Offers to which the candidate will be assigned with default stage. You can also pass one ID as offer_id

Response

201

Example response

{
  "candidate": {
    "last_activity_at": "2021-08-19T10:21:09.046935Z",
    "admin_id": 135145,
    "name": "John Smith",
    "gdpr_status": "no_consent",
    "photo_thumb_url": "https://recruitee-main.s3.eu-central-1.amazonaws.com/candidates/27746490/thumb_photo_vut6khmgetva.png",
    "updated_at": "2021-08-19T10:21:07.114867Z",
    "duplicates": [
      27721862
    ],
    "id": 27746490,
    "fields": [
      {
        "fixed": true,
        "kind": "language_skill",
        "options": {
          "levels": [
            "none"
          ]
        },
        "origin": "manual",
        "visibility": {
          "level": "public"
        },
        "visible": true
      }
    ],
    "cv_processing_status": "ok",
    "cover_letter": "Example cover letter",
    "photo_url": "https://recruitee-main.s3.eu-central-1.amazonaws.com/candidates/27746490/normal_photo_vut6khmgetva.png",
    "adminapp_url": "https://app.recruitee.com/#/dashboard/overview?candidate=27746490&company=49498",
    "emails": [
      "john@example.com"
    ],
    "placements": [
      {
        "candidate_id": 27746490,
        "created_at": "2021-08-19T10:21:08.958698Z",
        "id": 28978242,
        "offer_id": 487967,
        "position": 7,
        "stage_id": 4405724,
        "updated_at": "2021-08-19T10:21:08.958698Z"
      }
    ],
    "links": [
      "https://www.example.com/"
    ],
    "source": "manual",
    "social_links": [
      "https://www.facebook.com/johnexamplecom/"
    ],
    "phones": [
      "123123123"
    ],
    "created_at": "2021-08-19T10:21:07.114867Z"
  },
  "references": [
    {
      "id": 487967,
      "kind": "job",
      "lang_code": "en",
      "location": "Berlin, Germany",
      "position": 21,
      "slug": "test-offer",
      "status": "published",
      "title": "Test offer",
      "type": "Offer"
    }
  ]
}