Description
Adds one or multiple email domains to a specified suppression list.
Request URL
Method: POST
https://example.com/api/v1.1/suppresses/domains_add
Request parameters
| Parameter | Type | Example | Required | Description |
|---|---|---|---|---|
| token | string | "abcdefghijklmnqrstuvwxyz" | Yes | API token |
| domains | JSON array | ["example.com"] | Yes | Email domains list |
| format | string | "json" | No | Response data format. By default – json |
| id | int | 1 | Yes | Suppression list ID |
Request example
{
"domains": [
"example.com"
],
"id": 1,
"token": "abcdefghijklmnqrstuvwxyz"
}
Response example
{
"error": 0,
"error_text": "Successful operation",
"total_count": 1,
"total_duplicated": 0,
"total_imported": 1,
"total_updated": 0
}
Response parameters
| Parameter | Type | Description |
|---|---|---|
| error | int | Error code |
| error_text | string | Error text |
| total_count | int | Total number of domains |
| total_duplicated | int | Domains previously added to the stop list |
| total_imported | int | Domains added |
| total_updated | int | Domains updated (if matched) |