API endpoints
Suppressions
List, add and remove addresses on your suppression list.
usend never sends to addresses on your suppression list. See Bounces and suppressions.
The suppression object
{
"id": "0b4e6a3c-7d1f-4e2a-9b5c-3f8d2e1a6c74",
"email": "[email protected]",
"reason": "hard_bounce",
"created_at": "2026-10-11T09:12:48.230Z"
}reason is hard_bounce or complaint for addresses usend added automatically, and manual for addresses you added.
List suppressions
GET /suppressions
Newest first. Paginated.
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | No | 1 to 100. Default 50. |
after | string | No | Return suppressions older than this ID. |
before | string | No | Return suppressions newer than this ID. |
curl https://api.usend.et/suppressions \
-H "Authorization: Bearer us_123456789"{
"object": "list",
"data": [
{
"id": "0b4e6a3c-7d1f-4e2a-9b5c-3f8d2e1a6c74",
"email": "[email protected]",
"reason": "hard_bounce",
"created_at": "2026-10-11T09:12:48.230Z"
}
],
"has_more": false
}Add a suppression
POST /suppressions
Adds an address with reason manual. If the address is already suppressed, the existing entry is returned.
| Name | Type | Required | Description |
|---|---|---|---|
email | string | Yes | The address to suppress. Stored in lowercase. |
curl -X POST https://api.usend.et/suppressions \
-H "Authorization: Bearer us_123456789" \
-H "Content-Type: application/json" \
-d '{ "email": "[email protected]" }'{
"id": "5d1c2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
"email": "[email protected]",
"reason": "manual",
"created_at": "2026-10-11T10:00:00.000Z"
}Remove a suppression
DELETE /suppressions/{id}
Lets usend send to the address again.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The suppression ID (path). |
curl -X DELETE https://api.usend.et/suppressions/5d1c2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f \
-H "Authorization: Bearer us_123456789"{}