---
title: "/candidates"
method: POST
path: "/c/{company_id}/candidates"
---

# /candidates

`POST /c/{company_id}/candidates`

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

## Path parameters

- `company_id` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `candidate` object
    - `name` string, required — Candidate name
    - `remote_cv_url` string — Link to file saved on some external website. You can use candidate[cv] instead if you want to upload a file - see examples.
    - `emails` string[] — Array of emails
    - `phones` string[] — Array of phone numbers
    - `social_links` string[] — Array of social links
    - `links` string[] — Array of links
    - `cover_letter` string — Candidate's cover letter
    - `sources` string[] — Array of source tags
  - `offers` integer[] — Offers to which the candidate will be assigned with default stage. You can also pass one ID as `offer_id`

## Response `201`

201

- object
  - `candidate` object
    - `last_activity_at` string
    - `admin_id` integer
    - `my_last_rating` unknown
    - `name` string
    - `followed` boolean
    - `referrer` unknown
    - `gdpr_status` string
    - `online_data` unknown
    - `notes_count` integer
    - `last_message_at` unknown
    - `grouped_open_question_answers` unknown[]
      - unknown
    - `gdpr_expires_at` unknown
    - `photo_thumb_url` string
    - `pending_result_request` boolean
    - `open_question_answers` unknown[]
      - unknown
    - `unread_notifications` boolean
    - `updated_at` string
    - `duplicates` integer[]
    - `gdpr_consent_request_sent_at` unknown
    - `my_pending_result_request` boolean
    - `tags` unknown[]
      - unknown
    - `id` integer
    - `fields` object[]
      - `fixed` boolean
      - `id` unknown
      - `kind` string
      - `options` object
        - `levels` string[]
      - `origin` string
      - `values` unknown[]
        - unknown
      - `visibility` object
        - `admin_ids` unknown[]
          - unknown
        - `level` string
        - `role_ids` unknown[]
          - unknown
      - `visible` boolean
    - `admin_ids` unknown[]
      - unknown
    - `cv_original_url` unknown
    - `cv_processing_status` string
    - `referral_referrers_ids` unknown[]
      - unknown
    - `cover_letter` string
    - `positive_ratings` unknown
    - `attachments_count` integer
    - `photo_url` string
    - `gdpr_consent_request_type` unknown
    - `sources` unknown[]
      - unknown
    - `sourcing_data` unknown
    - `adminapp_url` string
    - `cv_url` unknown
    - `emails` string[]
    - `upcoming_event` boolean
    - `gdpr_consent_ever_given` boolean
    - `placements` object[]
      - `candidate_id` integer
      - `created_at` string
      - `id` integer
      - `language` unknown
      - `offer_id` integer
      - `overdue_at` unknown
      - `overdue_diff` unknown
      - `position` integer
      - `stage_id` integer
      - `updated_at` string
    - `example` boolean
    - `gdpr_consent_request_completed_at` unknown
    - `ratings` object
    - `gdpr_scheduled_to_delete_at` unknown
    - `in_active_share` boolean
    - `links` string[]
    - `source` string
    - `social_links` string[]
    - `custom_fields` unknown[]
      - unknown
    - `tasks_count` integer
    - `pending_request_link` boolean
    - `my_upcoming_event` boolean
    - `phones` string[]
    - `ratings_count` integer
    - `rating` integer
    - `created_at` string
    - `mailbox_messages_count` integer
    - `viewed` boolean
    - `sourcing_origin` unknown
  - `references` object[]
    - `id` integer
    - `kind` string
    - `lang_code` string
    - `location` string
    - `position` integer
    - `slug` string
    - `status` string
    - `title` string
    - `type` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/recruitee/apis/careers-site-api.md) · [All operations](https://skmtc.net/recruitee/apis/careers-site-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recruitee/careers-site-api/revisions/e9fbe3c5466d/schema)