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

# Add Batch Suppressions

> Bulk add multiple email addresses to the suppression list.

Import and block an array of email addresses in a single API call via the Mailofly API.

### Body Parameters

**suppressions** `array` *required*

List of suppression entries to add.

**properties**

**email** `string` *required*

The email address to suppress.

**reason** `string`

Reason (e.g. `manual`, `bounce`, `complaint`).

### Response

**data** `object`

**added** `number`

Number of email addresses added.

**suppressions** `array`

List of newly created records.

```bash cURL theme={null}
curl -X POST https://api.mailofly.com/suppressions/batch \
  -H "Authorization: Bearer mf_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "suppressions": [
      { "email": "user1@domain.invalid", "reason": "bounce" },
      { "email": "user2@domain.invalid", "reason": "complaint" }
    ]
  }'
```

```json 201 Created theme={null}
{
  "data": {
    "added": 2,
    "suppressions": [
      {
        "id": "sup_1",
        "email": "user1@domain.invalid",
        "reason": "bounce",
        "created_at": "2026-09-11T14:00:00Z"
      },
      {
        "id": "sup_2",
        "email": "user2@domain.invalid",
        "reason": "complaint",
        "created_at": "2026-09-11T14:00:00Z"
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.