> ## Documentation Index
> Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST Bulk delete contacts

> Delete multiple contacts in a single request.

## Endpoint

```txt theme={null}
POST /api/v1/contacts/bulk-delete
```

## Body

| Field        | Type    | Required | Description    |
| ------------ | ------- | -------- | -------------- |
| `contactIds` | UUID\[] | yes      | 1 to 10000 IDs |

## Success response `200`

```json theme={null}
{
  "data": {
    "requested": 2,
    "deleted": 1,
    "notFound": ["cnt_missing"]
  }
}
```

## Async response `202`

When `contactIds.length >= 100`, the operation runs in background.

```json theme={null}
{
  "data": {
    "mode": "async",
    "jobId": "job_abc123",
    "status": "pending",
    "operation": "bulk_delete_contacts",
    "requestedCount": 900,
    "progress": 0,
    "message": "Bulk operation queued. Check status via GET /api/contacts/bulk-jobs/job_abc123"
  }
}
```

## Notes

* `< 100` contacts: synchronous response
* `>= 100` contacts: asynchronous response with HTTP `202`
* Poll `GET /api/v1/contacts/bulk-jobs/{jobId}/progress` every `2s`