🚀 Jetzt neu: FlowAI! Ein revolutionärer Chat mit personalisierten AI-Agenten. 🌟

FlowSend API - für E-Mail-Marketing

Eine umfassende REST API zur Verwaltung von Subscribern, E-Mail-Listen und Tags. Perfekt für Newsletter-Integrationen, Marketing-Automationen und Daten-Synchronisation.

🔐 Schnellstart

Basis-URL: https://creativeskyline.de/api/flowsend/subscribers https://creativeskyline.de/api/flowsend/lists https://creativeskyline.de/api/flowsend/tags

1. API-Zugangsdaten abrufen

Bevor Sie die API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten: Melden Sie sich an, navigieren Sie zu Profil → API-Zugang und kopieren Sie Ihren persönlichen API-Key (pk_...).

2. Authentifizierung

Alle API-Anfragen benötigen diesen HTTP-Header:

Authorization: Bearer pk_dein_api_key
Accept: application/json

👥 Subscriber

Basis-URL: https://creativeskyline.de/api/flowsend/subscribers https://creativeskyline.de/api/flowsend/lists https://creativeskyline.de/api/flowsend/tags

Subscriber auflisten

GET /api/flowsend/subscribers

Ruft eine paginierte Liste aller Subscriber ab.

Query-Parameter:

status string Filter: subscribed, unsubscribed, bounced, complained, pending
source string Filter: manual, import, api, form, crm_sync
search string Suchbegriff (E-Mail, Name, Telefon)
lists[] array Array von Listen-UUIDs
tags[] array Array von Tag-UUIDs
per_page integer Anzahl pro Seite (1-200, Standard: 50)

Beispiel-Response:

{"success": true, "data": {"uuid": "550e8400-...", "email": "max@example.com", "firstname": "Max", "lastname": "Mustermann", "full_name": "Max Mustermann", "status": "subscribed", "source": "api", "lists": [{"uuid": "...", "title": "Newsletter"}], "tags": [{"uuid": "...", "title": "VIP-Kunde"}], "created_at": "2024-01-15T10:30:00+00:00"}}

Subscriber abrufen

GET /api/flowsend/subscribers/{uuid}

Ruft Details eines einzelnen Subscribers ab.

Subscriber erstellen

POST /api/flowsend/subscribers

Erstellt einen neuen Subscriber.

Request Body:

email string * E-Mail-Adresse des Subscribers
prefix string Anrede (z.B. Herr, Frau)
firstname string Vorname
lastname string Nachname
phone string Telefonnummer
status string Status (Standard: subscribed)
lists array Liste von Listen-UUIDs
tags array Liste von Tag-UUIDs
meta array Meta-Daten als Array von {key, value}-Objekten

Subscriber aktualisieren

PUT /api/flowsend/subscribers/{uuid}

Aktualisiert einen bestehenden Subscriber.

Request Body:

email string E-Mail-Adresse
firstname string Vorname
lastname string Nachname
status string Status (subscribed, unsubscribed)

Subscriber löschen

DELETE /api/flowsend/subscribers/{uuid}

Löscht einen Subscriber unwiderruflich.

Subscriber-Listen synchronisieren

PUT /api/flowsend/subscribers/{uuid}/lists

Ersetzt alle Listen-Zuordnungen des Subscribers (vollständige Synchronisation).

Request Body:

list_uuids array * Liste von Listen-UUIDs (ersetzt bestehende Zuordnungen)

Subscriber-Tags synchronisieren

PUT /api/flowsend/subscribers/{uuid}/tags

Ersetzt alle Tag-Zuordnungen des Subscribers (vollständige Synchronisation).

Request Body:

tag_uuids array * Liste von Tag-UUIDs (ersetzt bestehende Zuordnungen)

📦 Bulk-Operationen

Basis-URL: https://creativeskyline.de/api/flowsend/subscribers https://creativeskyline.de/api/flowsend/lists https://creativeskyline.de/api/flowsend/tags
Bulk-Löschen ist unwiderruflich
Die Aktion bulk/delete löscht alle angegebenen Subscriber permanent ohne Rückfrage.

Subscriber zu Listen hinzufügen

POST /api/flowsend/subscribers/bulk/add-to-lists

Fügt mehrere Subscriber gleichzeitig zu mehreren Listen hinzu.

Request Body:

subscriber_uuids array * UUIDs der Subscriber
list_uuids array * UUIDs der Ziel-Listen

Tags zu Subscribern hinzufügen

POST /api/flowsend/subscribers/bulk/add-tags

Weist mehreren Subscribern gleichzeitig mehrere Tags zu.

Request Body:

subscriber_uuids array * UUIDs der Subscriber
tag_uuids array * UUIDs der Ziel-Tags

Subscriber aus Listen entfernen

POST /api/flowsend/subscribers/bulk/remove-from-lists

Entfernt mehrere Subscriber gleichzeitig aus mehreren Listen.

Request Body:

subscriber_uuids array * UUIDs der Subscriber
list_uuids array * UUIDs der Listen

Tags von Subscribern entfernen

POST /api/flowsend/subscribers/bulk/remove-tags

Entfernt mehrere Tags gleichzeitig von mehreren Subscribern.

Request Body:

subscriber_uuids array * UUIDs der Subscriber
tag_uuids array * UUIDs der Tags

Subscriber bulk-löschen

POST /api/flowsend/subscribers/bulk/delete

Löscht mehrere Subscriber gleichzeitig. Diese Aktion ist unwiderruflich.

Request Body:

subscriber_uuids array * UUIDs der zu löschenden Subscriber

📜 Listen

Basis-URL: https://creativeskyline.de/api/flowsend/subscribers https://creativeskyline.de/api/flowsend/lists https://creativeskyline.de/api/flowsend/tags

Listen abrufen

GET /api/flowsend/lists

Ruft alle Listen ab, inklusive Subscriber-Anzahl.

Liste erstellen

POST /api/flowsend/lists

Erstellt eine neue Liste.

Request Body:

title string * Name der Liste
slug string URL-Slug (optional, wird automatisch generiert)
description string Beschreibung der Liste

Listen-Details abrufen

GET /api/flowsend/lists/{uuid}

Ruft Details einer bestimmten Liste ab.

Liste aktualisieren

PUT /api/flowsend/lists/{uuid}

Aktualisiert eine bestehende Liste.

Request Body:

title string Name der Liste
description string Beschreibung

Liste löschen

DELETE /api/flowsend/lists/{uuid}

Löscht eine Liste. Subscriber in dieser Liste werden nicht gelöscht.

🏷️ Tags

Basis-URL: https://creativeskyline.de/api/flowsend/subscribers https://creativeskyline.de/api/flowsend/lists https://creativeskyline.de/api/flowsend/tags

Tags abrufen

GET /api/flowsend/tags

Ruft alle Tags ab, inklusive Subscriber-Anzahl.

Tag erstellen

POST /api/flowsend/tags

Erstellt einen neuen Tag.

Request Body:

title string * Name des Tags
slug string URL-Slug (optional, wird automatisch generiert)
description string Beschreibung des Tags

Tag-Details abrufen

GET /api/flowsend/tags/{uuid}

Ruft Details eines bestimmten Tags ab.

Tag aktualisieren

PUT /api/flowsend/tags/{uuid}

Aktualisiert einen bestehenden Tag.

Request Body:

title string Name des Tags
description string Beschreibung

Tag löschen

DELETE /api/flowsend/tags/{uuid}

Löscht einen Tag. Subscriber mit diesem Tag verlieren die Zuordnung.