Klaviyo

In dieser Anleitung erfährst du, wie du in Klaviyo einen privaten API-Schlüssel erstellst, verwaltest und mit den richtigen Berechtigungen (Scopes) versiehst. Dieser Schlüssel ermöglicht die Integration von externen Systemen oder Skripten mit deinem Klaviyo-Konto.

---

🧰 Voraussetzungen

• Du hast Zugriff auf dein Klaviyo-Konto

• Du bist Kontoinhaber oder Administrator, da nur diese Rollen private API-Schlüssel erstellen dürfen

Weitere Informationen findest du in der offiziellen Hilfe: 👉 https://help.klaviyo.com/hc/de-de/articles/115005062267-How-to-manage-your-account-s-API-keys

Private API-Schlüssel bieten vollen oder eingeschränkten Zugriff auf dein Konto. Behandle sie daher wie ein Passwort und speichere sie sicher.

---

⚙️Schritt 1: Anmeldung bei Klaviyo

1. Melde dich in deinem Klaviyo-Konto an.

2. Navigiere unten links zu deinem Organisationsnamen.

3. Wähle im Menü „Einstellungen“.

4. Öffne die Registerkarte „API-Schlüssel“.

---

🧩 Schritt 2: Neuen privaten API-Schlüssel erstellen

1. Klicke auf „Privaten API-Schlüssel erstellen“.

2. Gib dem Schlüssel einen aussagekräftigen Namen, z. B.:

   • Shop-Integration

   • Newsletter-Automation

   • Datenexport-Tool

Wähle einen Namen, der den Verwendungszweck beschreibt – das erleichtert später die Verwaltung.

---

🔐 Schritt 3: Berechtigungen (Scopes) festlegen

Beim Erstellen des Schlüssels kannst du auswählen, welche Art von Zugriff erlaubt sein soll:

Typ	Beschreibung
🔍 Schreibgeschützt (Read only)	Nur Daten anzeigen, keine Änderungen erlaubt
✏️ Vollständig (Full access)	Daten lesen, erstellen, bearbeiten und löschen
⚙️ Benutzerdefiniert (Custom)	Detaillierte Auswahl einzelner Berechtigungen pro API-Endpunkt

Verwende „Vollständig“ nur, wenn unbedingt notwendig. Für die meisten Integrationen reicht „Schreibgeschützt“ oder „Benutzerdefiniert“ völlig aus.

---

⚙️ Schritt 4: Benutzerdefinierte Scopes auswählen

Wenn du „Benutzerdefiniert“ auswählst, kannst du für jeden Bereich gezielt festlegen, ob der Schlüssel lesen und/oder schreiben darf.

Bereich	Leseberechtigung (Read)	Schreibberechtigung (Write)
Kampagnen	campaigns:read	campaigns:write
Kataloge	catalogs:read	catalogs:write
Datenschutz	data-privacy:read	data-privacy:write
Events	events:read	events:write
Flows (Automationen)	flows:read	flows:write
Listen	lists:read	lists:write
Metriken	metrics:read	metrics:write
Profile	profiles:read	profiles:write
Segmente	segments:read	segments:write
Abonnements	subscriptions:read	subscriptions:write
Tags	tags:read	tags:write
Vorlagen (Templates)	templates:read	templates:write

Wähle nur die Scopes aus, die deine Integration tatsächlich benötigt – so minimierst du Sicherheitsrisiken.

---

🏁 Schritt 5: API-Schlüssel erstellen & speichern

1. Klicke auf „Erstellen“, um den API-Schlüssel zu generieren.

2. Notiere den Schlüssel sofort! Nach der Erstellung wird er nicht erneut angezeigt.

Wenn du den Schlüssel verlierst, musst du ihn neu erstellen. Speichere ihn an einem sicheren Ort (z. B. Passwort-Manager oder verschlüsselte Datei).

---

✅ Ergebnis

Du hast erfolgreich einen privaten API-Schlüssel in Klaviyo erstellt. Dieser Schlüssel kann nun in Integrationen, Skripten oder Anwendungen verwendet werden, die mit der Klaviyo API kommunizieren. Teste ihn mit einem einfachen Request, um sicherzustellen, dass deine Berechtigungen korrekt gesetzt sind.