FlowSend API Dokumentation - Creative Skyline

Navigation

🔐 Schnellstart

1. API-Token erstellen

Bevor Sie die API nutzen können, benötigen Sie einen API-Token:

Melden Sie sich in Ihrem Account an
Navigieren Sie zu Profil → API-Zugang
Erstellen Sie einen neuen API-Token
Kopieren Sie den Token und speichern Sie ihn sicher

🔑 Authentifizierung

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

Authorization: Bearer at_IHR_API_TOKEN

Content-Type: application/json

Accept: application/json

// Optional: Team auswählen

X-Team-UUID: ihre-team-uuid

3. Erste API-Anfrage

Testen Sie Ihre Verbindung:

curl -X GET "https://creativeskyline.de/api/flowsend/subscribers" \
  -H "Authorization: Bearer at_IHR_TOKEN" \
  -H "Accept: application/json"

👥 Subscribers

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

📋 Subscribers auflisten

GET /api/flowsend/subscribers

Ruft eine paginierte Liste aller Subscriber ab.

Query Parameter:

status - Filter: subscribed, unsubscribed, bounced, complained, pending

source - Filter: manual, import, api, form, crm_sync

search - Suchbegriff (E-Mail, Name, Telefon)

lists[] - Array von Listen-UUIDs

tags[] - Array von Tag-UUIDs

per_page - Anzahl (1-200, Standard: 50)

➕ Subscriber erstellen

POST /api/flowsend/subscribers

Erstellt einen neuen Subscriber.

Request Body:

{
  "email": "max@example.com",      // Pflichtfeld
  "prefix": "Herr",                // Optional
  "firstname": "Max",              // Optional
  "lastname": "Mustermann",        // Optional
  "phone": "+49123456789",         // Optional
  "status": "subscribed",          // Optional (default: subscribed)
  "lists": ["list-uuid-1"],        // Optional: Listen-UUIDs
  "tags": ["tag-uuid-1"],          // Optional: Tag-UUIDs
  "meta": [                        // Optional: Meta-Daten
    {"key": "company", "value": "Firma GmbH"}
  ]
}

✏️ Subscriber aktualisieren

PUT /api/flowsend/subscribers/{uuid}

Aktualisiert einen bestehenden Subscriber.

Listen synchronisieren:

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

{"list_uuids": ["uuid-1", "uuid-2"]}

Tags synchronisieren:

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

{"tag_uuids": ["uuid-1", "uuid-2"]}

📦 Bulk-Operationen

Zu Listen hinzufügen

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

{
  "subscriber_uuids": ["uuid-1", "uuid-2"],
  "list_uuids": ["list-uuid-1", "list-uuid-2"]
}

Tags hinzufügen

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

{
  "subscriber_uuids": ["uuid-1", "uuid-2"],
  "tag_uuids": ["tag-uuid-1", "tag-uuid-2"]
}

Aus Listen entfernen

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

Tags entfernen

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

Bulk-Löschen

POST /api/flowsend/subscribers/bulk/delete

{"subscriber_uuids": ["uuid-1", "uuid-2"]}

Achtung: Diese Aktion ist nicht rückgängig zu machen!

📜 Listen

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

GET /api/flowsend/lists

Alle Listen abrufen (inkl. Subscriber-Anzahl)

POST /api/flowsend/lists

Neue Liste erstellen

{
  "title": "Newsletter",
  "slug": "newsletter",     // Optional
  "description": "..."      // Optional
}

GET /api/flowsend/lists/{uuid}

Listen-Details abrufen

PUT /api/flowsend/lists/{uuid}

Liste aktualisieren

DELETE /api/flowsend/lists/{uuid}

Liste löschen

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

Alle Subscriber einer Liste abrufen (paginiert)

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

Subscriber zu einer Liste hinzufügen

{"subscriber_uuids": ["uuid-1", "uuid-2"]}

🏷️ Tags

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

GET /api/flowsend/tags

Alle Tags abrufen (inkl. Subscriber-Anzahl)

POST /api/flowsend/tags

Neuen Tag erstellen

{
  "title": "VIP-Kunde",
  "slug": "vip",           // Optional
  "description": "..."     // Optional
}

GET /api/flowsend/tags/{uuid}

Tag-Details abrufen

PUT /api/flowsend/tags/{uuid}

Tag aktualisieren

DELETE /api/flowsend/tags/{uuid}

Tag löschen

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

Alle Subscriber mit diesem Tag abrufen (paginiert)

💻 Code-Beispiele

cURL: Subscriber erstellen

curl -X POST "https://creativeskyline.de/api/flowsend/subscribers" \
  -H "Authorization: Bearer at_IHR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "max@example.com",
    "firstname": "Max",
    "lastname": "Mustermann",
    "lists": ["ihre-listen-uuid"],
    "tags": ["ihre-tag-uuid"]
  }'

PHP: Subscriber abrufen

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $apiToken,
    'Accept' => 'application/json',
])->get('https://creativeskyline.de/api/flowsend/subscribers', [
    'status' => 'subscribed',
    'per_page' => 100,
]);

$subscribers = $response->json()['data'];

Beispiel-Response

{
  "success": true,
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "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"
  }
}

Bulk-Operation: Tags zuweisen

curl -X POST "https://creativeskyline.de/api/flowsend/subscribers/bulk/add-tags" \
  -H "Authorization: Bearer at_IHR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber_uuids": [
      "550e8400-e29b-41d4-a716-446655440000",
      "550e8400-e29b-41d4-a716-446655440001"
    ],
    "tag_uuids": ["vip-tag-uuid"]
  }'

Response-Format

Erfolgreiche Antwort

{
  "success": true,
  "data": { ... },
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 100,
    "last_page": 2
  }
}

Fehler-Antwort

{
  "error": "Subscriber nicht gefunden"
}

HTTP Status Codes:

200 - Erfolg

201 - Erstellt

400 - Ungültige Anfrage

401 - Nicht authentifiziert

404 - Nicht gefunden

422 - Validierungsfehler

FlowSend API für E-Mail-Marketing