# Remove every recipient — replacing the list

Source: https://docs.usetone.ai/reference/campaigns/clearRecipients

> Clears the list so you can upload a different one.

`DELETE /v1/campaigns/{id}/recipients`
Clears the list so you can upload a different one. Only meaningful while the campaign is still a draft.

Requires the `write` scope.

## Parameters

| Name | In | | Meaning |
|---|---|---|---|
| `id` | path | required | The campaign's id. |

## Response

| Field | Type | | Meaning |
|---|---|---|---|
| `removed` | integer | required | How many recipients were removed. |

### Example response

```json
{
  "data": {
    "removed": 0
  }
}
```
