> ## 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.

# REST eMarketingManager

> Die Sperrliste des eMarketingManagers über REST pflegen: Adressen hinzufügen und bei einer Adressänderung die neue Adresse nachtragen.

Über diese Schnittstelle pflegen Sie die Sperrliste des eMarketingManagers aus Ihren eigenen Systemen heraus. Zwei Fälle deckt sie ab: eine Adresse neu sperren und bei einer Adressänderung die neue Adresse nachziehen.

Der zweite Fall ist der wichtigere und wird leicht übersehen. Wechselt ein Empfänger seine E-Mail-Adresse, wandert seine Sperre nicht automatisch mit. Ohne diesen Aufruf bekäme er unter der neuen Adresse wieder Post, obwohl er widersprochen hat.

Beide Aufrufe brauchen ein Token, siehe [REST-Authentifizierung](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-authentifizierung.md).

## Eintrag zur Sperrliste hinzufügen

```
POST https://www.websale.de/api/emm/addlock
```

Content-Type: `application/json`

| Eigenschaft | Typ | Beschreibung |
| - | - | - |
| `email` | string | E-Mail-Adresse, die gesperrt werden soll |
| `reason` | string | Begründung, warum die Adresse auf die Liste kommt |

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "email": "beispiel@websale.de",
    "reason": "telefonisch veranlasst"
}
```

Mit curl:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
curl \
 -X POST \
 -H "Content-Type: application/json" \
 -H "X-Authorization: Bearer eyJhbGciOiJIUzI1Ni...jBhOWMyMmRmNzFkOT==" \
 -d '{
    "email": "beispiel@websale.de",
    "reason": "telefonisch veranlasst"
}' \
"https://www.websale.de/api/emm/addlock"
```

Bei Erfolg antwortet der Server mit HTTP-Code 200 und leerem Inhalt. Im Fehlerfall kommt ein Code aus der 400er-Reihe.

## Eintrag in der Sperrliste aktualisieren

```
PUT https://www.websale.de/api/emm/changeemail
```

Content-Type: `application/json`

| Eigenschaft | Typ | Beschreibung |
| - | - | - |
| `oldadress` | string | Alte E-Mail-Adresse, nach der in der Sperrliste gesucht wird |
| `newaddress` | string | Neue E-Mail-Adresse, die eingetragen wird, sofern die alte gefunden wurde |

Die neue Adresse kommt nur dann auf die Liste, wenn die alte dort steht. Ein Aufruf für eine nicht gesperrte Adresse bleibt also folgenlos, was den Aufruf unkritisch macht: Sie können ihn bei jeder Adressänderung absetzen, ohne vorher zu prüfen.

Bei Erfolg antwortet der Server mit HTTP-Code 200 und leerem Inhalt.

## Verwandte Themen

* Wegweiser: [REST-Schnittstelle für OSB-Dienste](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste.md)
* Wegweiser: [eMarketingManager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)


## Related topics

- [REST-Schnittstelle für OSB-Dienste](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste.md)
- [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)
- [Materialien E-Marketing-Manager](https://dokumentation.websale.de/v8s/materialien/materialien-emarketing-manager.md)
- [Migration von Newsletter V2 zu E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/migration-von-newsletter-v2-zu-e-marketing-manager.md)
- [Allgemeine Online-Dienste](https://dokumentation.websale.de/v8s/online-servicebereich/allgemeine-online-dienste.md)


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