---
title: "Initiate a new bulk email"
method: POST
path: "/bulk_action/email/"
tags: ["bulk_actions.email"]
---

# Initiate a new bulk email

`POST /bulk_action/email/`

`contact_preference` can be set to `lead` (only email the primary/first contact email of the lead) or `contact` (email the first contact email of each contact of the lead).

## Response `200`

Successful response

- BulkEmailAction
  - `contact_preference` 'lead' | 'contact' | 'all', required
  - `created_by` string, nullable, required
  - `date_created` string, date-time, nullable, required
  - `date_updated` string, date-time, nullable, required
  - `email_account_id` string, nullable, required
  - `id` string, required
  - `n_leads` integer, nullable, required
  - `n_leads_processed` integer, required
  - `n_objects` integer, nullable, required
  - `n_objects_processed` integer, required
  - `organization_id` string, required
  - `query` string, nullable, required
  - `results_limit` integer, nullable, required
  - `s_query` object, required
  - `send_done_email` boolean, required
  - `sender` string, nullable, required
  - `sort` object[], required
  - `status` 'created' | 'loading' | 'processing' | 'done' | 'paused' | 'resuming' | 'error', required
  - `template_id` string, nullable, required
  - `updated_by` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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