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

# API-Referenz Blacklist

> Newsletter-Blacklist über die Admin Interface API verwalten: E-Mail-Adressen vom Versand ausschließen oder Einträge wieder entfernen.

Die Schnittstelle `/blacklist/` ermöglicht die Verwaltung einer Blacklist für E-Mail-Adressen, die vom Versand von Newslettern ausgeschlossen werden sollen.

Über entsprechende Endpunkte können neue Einträge hinzugefügt oder bestehende gelöscht werden.

***

## Unterstützte Methoden

Angabe aller unterstützten Methoden.

| **Befehl/Info**         | **Endpunkte** | **GET**             | **POST**              | **PUT**             | **DELETE**          |
| ----------------------- | ------------- | ------------------- | --------------------- | ------------------- | ------------------- |
| **Blacklist verwalten** | blacklist/    | <Icon icon="ban" /> | <Icon icon="check" /> | <Icon icon="ban" /> | <Icon icon="ban" /> |

## Verwendung der Methoden

### POST blacklist/add

Dieser Endpunkt fügt eine E-Mail-Adresse zur Blacklist hinzu.

Die Adresse wird im Request-Body übermittelt und bei erfolgreicher Verarbeitung als Hash gespeichert. Die Antwort gibt an, ob die Operation erfolgreich war (`true`) oder fehlgeschlagen ist (`false`).

Der Zugriff auf diesen Endpunkt erfordert ein Benutzerkonto mit entsprechenden Berechtigungen.

#### Beispiel

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.<ihr-shop>.de/admin/api/v1/blacklist/add
```

#### Request Body

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "email": "example@example.com"
}
```

#### Antwort

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
true/false
```

#### Fehlercodes

| **Fehler**       | **Typ**            | **Grund**                                                                            |
| ---------------- | ------------------ | ------------------------------------------------------------------------------------ |
| 401 Unauthorized |                    | Nicht autorisiert: Sie sind nicht angemeldet.                                        |
| 403 Forbidden    |                    | Sie verfügen nicht über die erforderlichen Rechte zum Schreiben von Blacklist-Daten. |
| 400 Bad Request  |                    | Request body konnte nicht geladen werden.                                            |
| 400 Bad Request  | "missing"          | `email` wurde nicht übergeben.                                                       |
| 400 Bad Request  | "invalidFormat"    | `email` ist kein String.                                                             |
| 400 Bad Request  | "invalidValue"     | `email` darf nicht leer sein.                                                        |
| 400 Bad Request  | "unknownDataField" | Es wurde ein unbekanntes Feld übergeben.                                             |

### POST blacklist/remove

Dieser Endpunkt entfernt eine E-Mail-Adresse aus der Blacklist.

Die Adresse wird im Request-Body übermittelt. Die Antwort gibt an, ob die Operation erfolgreich war (`true`) oder fehlgeschlagen ist (`false`).

Der Zugriff auf diesen Endpunkt erfordert ein Benutzerkonto mit entsprechenden Berechtigungen.

#### Beispiel

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.<ihr-shop>.de/admin/api/v1/blacklist/remove
```

#### Request Body

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "email": "example@example.com"
}
```

#### Antwort

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
true/false
```

#### Fehlercodes

| **Fehler**       | **Typ**            | **Grund**                                                                          |
| ---------------- | ------------------ | ---------------------------------------------------------------------------------- |
| 401 Unauthorized |                    | Nicht autorisiert: Sie sind nicht angemeldet.                                      |
| 403 Forbidden    |                    | Sie verfügen nicht über die erforderlichen Rechte zum Löschen von Blacklist-Daten. |
| 400 Bad Request  |                    | Request body konnte nicht geladen werden.                                          |
| 400 Bad Request  | "missing"          | `email` wurde nicht übergeben.                                                     |
| 400 Bad Request  | "invalidFormat"    | `email` ist kein String.                                                           |
| 400 Bad Request  | "invalidValue"     | `email` darf nicht leer sein.                                                      |
| 400 Bad Request  | "unknownDataField" | Es wurde ein unbekanntes Feld übergeben.                                           |

## Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: [Zum Kundenportal](https://websale.atlassian.net/servicedesk/customer/portal/6)

Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.


## Related topics

- [Admin Interface API](/schnittstellen/admin-interface-api.md)
- [API-Referenz Benutzerverwaltung](/schnittstellen/admin-interface-api/api-referenz-benutzerverwaltung.md)
- [API-Referenz Newsletter](/schnittstellen/admin-interface-api/api-referenz-newsletter.md)
- [API-Referenz Produkte](/schnittstellen/admin-interface-api/api-referenz-produkte.md)
- [API-Referenz Kategorien](/schnittstellen/admin-interface-api/api-referenz-kategorien.md)