API

Um das API für den Versand zu nutzen, legen Sie ein API-Token an. Erstellen Sie dazu ein Token unter Angabe einer beliebigen Beschreibung, mit der Sie die Verwendung des Tokens identifizieren können.

Sobald Sie ein API-Token angelegt haben, wird es Ihnen einmalig angezeigt. Das Token ist danach nicht mehr abrufbar und wenn Sie es verlieren, müssen Sie es zurücksetzen und neu generieren.

Mit dem API-Token können Sie nun mit dem mailomat-API verbinden und POST- und GET-Requests absetzen.

Ein API-Request ist nach folgendem Schema aufgebaut:

GET https://api.mailomat.swiss/events
Authorization: Bearer your-token-generated-from-within-the-application
User-Agent: Your-API-Client/1.0.0
Accept: application/json

Die API-Dokumentation finden Sie unter: https://api.mailomat.swiss/docs

Mailomat wurde im Jahr 2023 veröffentlicht und hat im Q1/2024 den BETA-Status verlassen. Der Ausbau der Features geht weiter und dies kann unter Umständen auch die API-Struktur betreffen. Es könnte daher in Zukunft nötig werden, Änderung an der API-Struktur vorzunehmen, die möglicherweise nicht rückwärtskompatibel sind. Dies gilt insbesondere für den Payload von Events und Webhooks.

Selbstverständlich werden wir allfällige Änderungen an der API so früh wie kommunizieren. Bitte stellen Sie zu diesem Zweck sicher, dass Sie unsere Newsletter erhalten.