> For a complete page index, fetch https://developer.close.com/llms.txt

# Bulk Actions

Bulk actions let you email, edit, delete, or subscribe leads in bulk.

#### Lead filtering

To initiate bulk actions for a subset of leads, provide the structured filtering values from the [Advanced Filtering API](/api/resources/advanced-filtering) such as `query`, `results_limit`, and `sort` fields. The only difference is that Bulk Actions endpoints require you to rename the `query` field to `s_query` (shorthand for structured query).

For example, this is the payload you would send to the Advanced Filtering API:

```json
{
    "query": {
        "queries": [...]
    },
    "results_limit": 100,
    "sort": [{...}]
}
```

And this is the equivalent Bulk Actions payload (note `query` -> `s_query`):

```json
{
    "s_query": {
        "queries": [...]
    },
    "results_limit": 100,
    "sort": [{...}]
}
```

#### Pausing and resuming

You can pause an in-progress bulk action by sending `{ "status": "paused" }`. You can resume it afterwards with `{ "status": "resuming" }`, unless more than 7 days have passed since you paused the action.

#### Receiving an email when done

By default a confirmation email is sent when a bulk action completes. Set `"send_done_email": false` in the request if you don't want this.

> Perform bulk operations on leads matching a search query or smart view.


## API Docs

- Email [List bulk emails](https://developer.close.com/api/resources/bulk-actions/email/list.md)
- Email [Initiate a new bulk email](https://developer.close.com/api/resources/bulk-actions/email/create.md)
- Email [Fetch a single bulk email object](https://developer.close.com/api/resources/bulk-actions/email/get.md)
- Edit [List bulk edits](https://developer.close.com/api/resources/bulk-actions/edit/list.md)
- Edit [Initiate a new bulk edit](https://developer.close.com/api/resources/bulk-actions/edit/create.md)
- Edit [Fetch a single bulk edit object](https://developer.close.com/api/resources/bulk-actions/edit/get.md)
- Delete [List bulk deletes](https://developer.close.com/api/resources/bulk-actions/delete/list.md)
- Delete [Initiate a new bulk delete](https://developer.close.com/api/resources/bulk-actions/delete/create.md)
- Delete [Fetch a single bulk delete object](https://developer.close.com/api/resources/bulk-actions/delete/get.md)
- Bulk Sequence Subscriptions [List bulk sequence subscriptions](https://developer.close.com/api/resources/bulk-actions/sequence-subscriptions/list.md)
- Bulk Sequence Subscriptions [Initiate a new bulk sequence subscription](https://developer.close.com/api/resources/bulk-actions/sequence-subscriptions/create.md)
- Bulk Sequence Subscriptions [Fetch a single bulk sequence subscription object](https://developer.close.com/api/resources/bulk-actions/sequence-subscriptions/get.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developer.close.com/api/resources/bulk-actions/openapi.json)
- [OpenAPI YAML](https://developer.close.com/api/resources/bulk-actions/openapi.yaml)