---
title: "Add a candidate to a job, candidates will show up under the Sourced stage"
method: POST
path: "/api/external/candidate/add-to-job"
tags: ["Candidate APIs"]
---

# Add a candidate to a job, candidates will show up under the Sourced stage

`POST /api/external/candidate/add-to-job`

## Headers

- `RF-Api-Key` string, required
- `content-type` string

## Request body

- object
  - `added_time` string
  - `applied` integer — 0 = Sourced (default when omitted), 1 = Applied. Applied triggers Welcome Mail recipes.
  - `id` integer
  - `job_id` integer

## Response `200`

Auto generated using Swagger Inspector

- object
  - `RESULT` string

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/candidate/add-to-job/post.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)