Listen

Mit Mailinglisten können Sie Abonnenten für gezielte Kampagnen in Gruppen organisieren. Jeder Abonnenten-Datensatz gehört zu einer Liste, aber dieselbe E-Mail-Adresse kann separate Datensätze in mehreren Listen haben, und Kampagnen können eine bestimmte Liste oder ein Segment innerhalb einer Liste ansprechen.

Liste erstellen

POST https://api.mail.land/v1/marketing/lists

Create list request

{
  "name": "Product Updates",
  "description": "Subscribers interested in product announcements"
}

Feld	Typ	Erforderlich	Beschreibung
`name`	string	Ja	Listenname (muss pro Arbeitsbereich eindeutig sein)
`description`	string	Nein	Listenbeschreibung

Create a mailing list

curl -X POST https://api.mail.land/v1/marketing/lists \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product Updates", "description": "Product announcements" }'

Antwort

List response

{
  "id": "vtmlew96u277jq",
  "name": "Product Updates",
  "description": "Product announcements",
  "isActive": true,
  "subscriberCount": 0,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Alle Mailinglisten auflisten

GET https://api.mail.land/v1/marketing/lists

Parameter	Typ	Standard	Beschreibung
`cursor`	string	-	Opaker Cursor aus dem `nextCursor` der vorherigen Seite. Für die erste Seite weglassen.
`limit`	int	20	Einträge pro Seite
`search`	string	-	Nach Name suchen
`isActive`	bool	-	Nach aktivem Status filtern
`sortBy`	string	-	Sortierfeld
`sortDesc`	bool	false	Absteigende Sortierung

List all mailing lists

curl "https://api.mail.land/v1/marketing/lists?limit=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

List response

{
  "items": [
    {
      "id": "vtmlew96u277jq",
      "name": "Product Updates",
      "description": "Product announcements",
      "isActive": true,
      "subscriberCount": 2500,
      "createdAt": "2026-01-10T08:00:00Z",
      "updatedAt": "2026-02-17T12:00:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Listendetails abrufen

GET https://api.mail.land/v1/marketing/lists/{id}

Gibt erweiterte Details einschließlich der Abonnentenaufschlüsselung zurück:

Get list details

curl https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

List detail response

{
  "id": "vtmlew96u277jq",
  "name": "Product Updates",
  "description": "Product announcements",
  "isActive": true,
  "subscriberCount": 2500,
  "activeSubscribers": 2300,
  "unsubscribedCount": 150,
  "bouncedCount": 50,
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Liste aktualisieren

PUT https://api.mail.land/v1/marketing/lists/{id}

Update list request

{
  "name": "Product Announcements",
  "description": "Updated description",
  "isActive": true
}

Feld	Typ	Erforderlich	Beschreibung
`name`	string	Ja	Listenname (muss eindeutig sein)
`description`	string	Nein	Listenbeschreibung
`isActive`	bool	Nein	Aktiver Status (Standard: `true`)

isActive ist nur ein Label: es auf false zu setzen, blockiert das Senden nicht. Nichts im Kampagnen- oder Worker-Code liest dieses Feld, um eine Kampagne daran zu hindern, diese Liste anzusprechen.

Update a mailing list

curl -X PUT https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Announcements",
    "description": "Updated description",
    "isActive": true
  }'

Liste löschen

DELETE https://api.mail.land/v1/marketing/lists/{id}

Löscht die Mailingliste. Abonnenten in dieser Liste werden nicht gelöscht, aber ihre mailingListId wird geleert (ein SetNull-Fremdschlüssel). Listenbezogene Abmeldungen bleiben beim Löschen einer Liste erhalten.

Hat ein Abonnent dieser Liste bereits einen Kontakt ohne Liste (etwa weil er in einer zuvor gelöschten Liste war), bleibt dieser Kontakt bestehen, und seine Mitgliedschaft in dieser Liste wird nur als Verlauf aufbewahrt: Sie erscheint nicht mehr in den Kontakten, und keine Kampagne oder Automatisierung zielt auf sie. Abmeldungen, Einwilligungsnachweise und Kampagnenverlauf bleiben erhalten.

Delete a mailing list

curl -X DELETE https://api.mail.land/v1/marketing/lists/vtmlew96u277jq \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Fehlerantworten

Status	Code	Beschreibung
`400`	`VALIDATION_FAILED`	Name ist erforderlich
`400`	`INVALID_REQUEST`	Eine Mailingliste mit diesem Namen existiert bereits
`403`	`FORBIDDEN`	Unzureichende Berechtigungen
`404`	`RESOURCE_NOT_FOUND`	Mailingliste nicht gefunden

Nächste Schritte

Abonnenten: fügen Sie Abonnenten zu Ihren Listen hinzu
Segmente: erstellen Sie dynamische Segmente innerhalb von Listen
Kampagnen: senden Sie Kampagnen an Ihre Listen

Listen

Liste erstellenLink zum Abschnitt kopieren

AntwortLink zum Abschnitt kopieren

Alle Mailinglisten auflistenLink zum Abschnitt kopieren

Listendetails abrufenLink zum Abschnitt kopieren

Liste aktualisierenLink zum Abschnitt kopieren

Liste löschenLink zum Abschnitt kopieren

FehlerantwortenLink zum Abschnitt kopieren

Nächste SchritteLink zum Abschnitt kopieren

Auf dieser Seite