---
title: "Email candidates"
method: POST
path: "/candidates/email"
tags: ["candidate"]
---

# Email candidates

`POST /candidates/email`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/candidates/email`
- Auth: HTTP bearer

Emails one or more candidates from you, as "{your name} at {Company} via Binderwork", with replies to your own address. {candidate_first_name}, {job_title}, {company}, {sender_name} and {booking_link} fill in for each. Each email waits ten minutes before it goes, so it can be undone. With move_to, the applications move to that stage in the same call.

## Request body

- object
  - `application_ids` string[], required
  - `template` 'received' | 'next_step' | 'rejection_applied' | 'rejection_interview'
  - `subject` string, required
  - `body` string, required
  - `move_to` 'applied' | 'screen' | 'interview' | 'offer'

## Response `200`

The result.

- object
  - `queued` object[], required
    - `id` string, required
    - `application_id` string, required
    - `send_at` string, date-time, required
  - `moved` object[], required
    - `id` string, required
    - `from` string, required
    - `to` string, required

## Other responses

- `202`: Called by an agent or an API key, so the call did not run. A person approves it at approval_url; then GET the Location.
- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)