So stellst du Open Badges aus einer CSV in unter 5 Minuten aus

Wenn du jemals Credentials an eine Kohorte einen Empfänger nach dem anderen ausgestellt hast, kennst du das Problem bereits: Es skaliert nicht über etwa zehn Personen hinaus, bevor es in einen Nachmittag voller Kopieren und Einfügen von Namen und E-Mails ausartet. Eine Bootcamp-Kohorte mit 40 Personen, eine Teilnehmerliste einer Konferenz mit 500 Personen oder ein Schulungs-Rollout im Unternehmen mit 5.000 Personen brauchen alle dasselbe — Liste hochladen, ein Abzeichen wählen, auf Ausstellen klicken, weggehen.

Genau das leisten Bulk Credentials auf https://badges.ninja. Diese Anleitung deckt den gesamten Ablauf ab: deine CSV vorbereiten, den Stapel konfigurieren, ihm beim Laufen zusehen und die chaotischen Fälle der echten Welt handhaben — eine Empfängerzeile mit einem Tippfehler, ein Stapel, der auf halbem Weg unterbrochen wird, oder ein Programm, das auf dieselbe Weise aus den eigenen Systemen statt aus dem Dashboard ausstellen möchte.

Bevor du loslegst: Was du brauchst

Zwei Dinge, die du vermutlich beide schon hast:

1. Ein Abzeichen — einmal im visuellen Designer entworfen, für jeden Empfänger im Stapel wiederverwendet. Falls du noch keins gebaut hast, sieh dir unseren Leitfaden zum Entwerfen deines ersten verifizierbaren Zertifikats an.
2. Eine CSV mit Empfängern — Name, E-Mail und (optional) ein Ausstellungsdatum. Das ist das ganze Schema.

Du brauchst kein Aussteller-Konto pro Empfänger, keinen Mailserver und keinen Code. Alles in diesem Abschnitt passiert im Dashboard.

Schritt 1: Bereite deine CSV vor

Das Format der Empfängerliste ist bewusst minimal gehalten:

name,email,issued_on
Maria Gonzalez,maria@example.com,2026-07-01
David Kim,david@example.com,2026-07-01
Priya Patel,priya@example.com,

• name — erforderlich. Befüllt das Empfängerfeld auf der Assertion und dem Zertifikat.
• email — erforderlich. Sie wird zur Empfängeridentität auf der Open Badge v2.0 Assertion — mit einem credential-spezifischen Salt gehasht, bevor sie gespeichert wird, niemals im Klartext aufbewahrt.
• issued_on — optional. Lass es leer und der Stapel verwendet den Moment, in dem jede Zeile verarbeitet wird; setze es explizit, wenn du eine Kohorte nacherfasst, die tatsächlich letzten Monat abgeschlossen hat.

Die meisten Programmverantwortlichen exportieren das direkt von dort, wo sie Abschlüsse ohnehin schon nachverfolgen — Airtable, Google Sheets, eine von einer Dozentin übergebene Tabelle oder eine aus einem LMS-Notenbuch gezogene CSV. Es ist kein spezielles Export-Werkzeug nötig; jede CSV mit diesen drei Spalten funktioniert.

Häufige CSV-Fallstricke (und wie die Vorschau sie abfängt)

Eine Handvoll Probleme taucht in echten Empfängerlisten ständig auf, meist weil die CSV durch das Zusammenführen von zwei oder drei Quelltabellen entstanden ist:

• Nachgestellte Leerzeichen in E-Mail-Adressen — ein Kopieren aus einer PDF-Liste oder ein Export aus einem Google Form schleppt oft ein unsichtbares Leerzeichen mit. In einer Tabellenzelle sieht es gut aus, scheitert aber beim Hochladen an der E-Mail-Validierung.
• Doppelte Zeilen — derselbe Empfänger taucht zweimal auf, weil eine Kohortenliste und eine Liste von Nachzüglern ohne Deduplizierung aneinandergehängt wurden.
• Inkonsistente Datumsformate — eine Spalte mit 2026-07-01 gemischt mit 07/01/2026 aus einem anderen Export. Halte dich an ISO 8601 (YYYY-MM-DD) und das verschwindet vollständig.
• Nicht übereinstimmende Groß-/Kleinschreibung der Kopfzeilen — Email vs. email vs. E-mail. Der Parser ist bei gängigen Varianten nachsichtig, aber ein komplett eigener Kopfzeilenname wird nicht automatisch zugeordnet.

Keines davon ist fatal — der Vorschauschritt (unten) bringt jedes einzelne zutage, bevor irgendetwas ausgestellt wird, sodass die Korrektur „Tabelle bearbeiten, erneut hochladen” lautet statt „herausfinden, welcher von 3.000 Empfängern ein kaputtes Abzeichen bekommen hat”.

Schritt 2: Konfiguriere den Stapel

Öffne im Dashboard Credentials → Bulk Credentials und wähle das Abzeichen, das du ausstellst. Das ist der Schritt, in dem du alles festlegst, was für den gesamten Stapel gilt: das Abzeichen selbst, ein gemeinsames Ausstellungsdatum, falls du keine zeilenweisen Datumsangaben in die CSV setzt, und (falls dein Ausstellerprofil eine hat) die LinkedIn-Organisations-ID, die es jedem Empfänger erlaubt, das Credential mit einem Klick zu seinem Profil hinzuzufügen.

Das ist ein guter Moment, um noch einmal zu prüfen, ob das ausgewählte Abzeichen die endgültige Version ist — Empfänger sehen genau das Bild und die Kriterien, die im Moment der Ausstellung daran hängen, nicht das, was du später daran änderst.

Schritt 3: Hochladen und Vorschau

Lege deine CSV ab und die Plattform parst sie, zeigt dir eine Vorschautabelle und markiert alles, was sie nicht verarbeiten kann — eine fehlende E-Mail, ein fehlerhaftes Datum, eine doppelte Zeile. Es wird nichts ausgestellt, bis du die Vorschau bestätigst.

Dieser Vorschauschritt ist wichtiger, als er aussieht. Ein Tippfehler in einer Zeile einer CSV mit 2.000 Zeilen ist mit bloßem Auge leicht zu übersehen, und es ist viel günstiger, ihn abzufangen, bevor 1.999 korrekte Zeilen bereits ausgestellt sind, als zu versuchen, das im Nachhinein rückgängig zu machen. Korrigiere die markierten Zeilen in deiner Tabelle, lade sie erneut hoch, und die Vorschau aktualisiert sich.

Schritt 4: Lass den Stapel laufen

Klick auf Ausstellen und der Stapel beginnt mit der Verarbeitung. Ein Fortschrittsbalken verfolgt erledigte gegenüber verbleibenden Zeilen, und der Stapel läuft serverseitig — du musst den Tab nicht offen halten, und das Zuklappen deines Laptops mitten im Stapel kostet dich deinen Platz nicht.

Dieser letzte Punkt ist es wert, ausbuchstabiert zu werden, denn es ist das Detail, auf das es bei großen Kohorten wirklich ankommt: Der Stapelzustand lebt auf dem Server, nicht in deinem Browser. Wenn deine Verbindung abbricht, dein Laptop in den Ruhezustand geht oder du den Tab einfach schließt, weil ein Meeting beginnt, läuft der Stapel weiter (oder setzt genau dort fort, wo er aufgehört hat, falls du ihn pausiert hast), statt bei null neu zu starten. Für eine Bootcamp-Kohorte mit 40 Personen ist das ein nettes Extra. Für ein Unternehmens-Rollout mit 5.000 Zeilen ist es der Unterschied zwischen „es funktioniert einfach” und „jemand muss zwanzig Minuten lang einen Browser-Tab babysitten”.

Du kannst einen laufenden Stapel auch bewusst pausieren — sagen wir, jemand meldet, dass der Kriterientext des Abzeichens auf halbem Weg eines 3.000-Zeilen-Laufs eine Anpassung braucht — das Problem beheben und fortsetzen, ohne die bereits erledigten Zeilen erneut auszustellen.

Schritt 5: Fehler behandeln

Echte Empfängerlisten haben schlechte Zeilen: eine vertippte E-Mail-Domain, ein Namensfeld, das eigentlich leer ist, ein doppelter Eintrag durch das Zusammenführen zweier exportierter Tabellen. Wenn eine Zeile fehlschlägt, stoppt der Stapel nicht — er verarbeitet den Rest weiter und markiert den Fehlschlag zur späteren Überprüfung. Du erhältst einen Ergebnis-Export, der genau zeigt, welche Zeilen erfolgreich waren und welche nicht, sodass du nur die fehlgeschlagenen Zeilen korrigieren und einen kleinen Folge-Stapel erneut ausführen kannst, statt die ganze Liste erneut zu prüfen.

Das ist wichtig für die CSV-Export-Gewohnheit, die auf dem Credentials-Dashboard bereits verbreitet ist — du kannst jederzeit eine CSV dessen ziehen, was tatsächlich ausgestellt wurde, sie mit deiner Quellliste abgleichen und genau wissen, wer noch ein Abzeichen braucht.

Der API-Weg: Gleicher Ablauf, kein Dashboard

Alles oben Genannte setzt voraus, dass jemand am Dashboard sitzt und sich durch den Assistenten klickt. Wenn deine Abschlüsse bereits in einem System leben — einem LMS, einem CRM, einer Tabellenautomatisierung — kannst du denselben Bulk-Credential-Ablauf direkt über die Awards API steuern.

Ein minimaler Ausstellungsaufruf pro Empfänger sieht so aus:

curl -X POST https://api.badges.ninja/awards \
  -H "X-Api-Key: bws_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d" \
  -H "Content-Type: application/json" \
  -d '{
    "badgeId": "badge_9f8e7d6c5b4a",
    "recipient": {
      "name": "Maria Gonzalez",
      "email": "maria@example.com"
    },
    "issuedOn": "2026-07-01T00:00:00Z"
  }'

Oder in Python, über Zeilen iterierend, die aus derselben CSV gelesen werden, die du sonst von Hand hochladen würdest:

import csv
import requests

API_KEY = "bws_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"
BADGE_ID = "badge_9f8e7d6c5b4a"

with open("recipients.csv") as f:
    for row in csv.DictReader(f):
        requests.post(
            "https://api.badges.ninja/awards",
            headers={"X-Api-Key": API_KEY},
            json={
                "badgeId": BADGE_ID,
                "recipient": {"name": row["name"], "email": row["email"]},
                "issuedOn": row.get("issued_on") or None,
            },
        )

Dazu zu greifen lohnt sich, wenn die Ausstellung von Credentials durch etwas ganz anderes ausgelöst wird — einen Webhook für Kursabschlüsse, eine CRM-Statusänderung, ein Formular-Absenden — statt durch eine Person, die manuell eine CSV exportiert. Wir behandeln die Authentifizierung und die vollständige Request-/Response-Form im API-Schnellstart. Jedes auf diese Weise erstellte Credential ist identisch mit einem, das über den Dashboard-Assistenten erstellt wurde: dieselbe Open Badge v2.0 Assertion, dieselbe Verifizierungs-URL, dasselbe PDF-Zertifikat.

Dashboard-Assistent vs. API: Welchen willst du wirklich?

Die meisten Teams starten mit dem Dashboard-Assistenten, weil er nichts weiter als eine CSV verlangt, und wechseln erst dann zur API, wenn derselbe Stapel drei- oder viermal manuell ausgeführt wurde und das Muster offensichtlich die Automatisierung wert ist.

Datenschutz: Was tatsächlich gespeichert wird

Eine CSV mit Namen und E-Mails ist personenbezogene Daten, und es lohnt sich zu wissen, was nach dem Hochladen damit geschieht. Die E-Mail-Adresse des Empfängers wird niemals im Klartext auf dem Credential selbst gespeichert — sie wird als Teil der Open Badge v2.0 Assertion mit einem credential-spezifischen Salt gehasht, gemäß dem hashed-Format der Empfängeridentität aus der Spezifikation. Dieser Hash ist das, was ein Prüfer abgleicht, nicht die rohe Adresse. Das Namensfeld wird so gespeichert, wie es eingegeben wurde, da es auf dem Zertifikat und der Verifizierungsseite sichtbar sein soll. Wenn eine Zeile nach der Ausstellung korrigiert werden muss — am häufigsten ein falsch geschriebener Name — kannst du das einzelne Credential über das Credentials-Dashboard bearbeiten oder widerrufen, ohne den Rest des Stapels anzurühren.

Nach dem Stapel: Benachrichtige die Empfänger

Das Abzeichen auszustellen und den Empfänger davon in Kenntnis zu setzen sind zwei verschiedene Schritte. Wenn deine CSV nicht ohnehin schon eine E-Mail über dein eigenes System auslöst, erlaubt dir der Bulk-Share-Ablauf des Dashboards, die gerade erstellten Credentials per Mehrfachauswahl zu markieren und allen in einem Durchgang eine personalisierte Share-E-Mail zu senden — siehe Share-E-Mails in großen Mengen versenden für die vollständige Anleitung, einschließlich wie die Personalisierung pro Empfänger (Name, Abzeichenbild, Verifizierungslink) automatisch eingesetzt wird.

Wann Bulk Credentials das richtige Werkzeug ist

Die Massenausstellung ist die richtige Wahl, wann immer der Rahmen „Stapel” zur echten Welt passt: eine Kohorte, die am selben Tag fertig wurde, eine Konferenz, die gerade endete, ein Schulungs-Rollout, das eine Compliance-Frist erreicht. Wenn du stattdessen einzelne Credentials ausstellst, während individuelle Meilensteine erreicht werden — eine einzelne Beförderung, ein einzelner Projektabschluss — ist das Formular für Einzel-Credentials schneller, als eine einzeilige CSV zusammenzustellen.

Für alles Wiederkehrende — derselbe Kurs, der jeden Monat läuft, eine rollierende Onboarding-Pipeline — ist der API-Weg oben es wert, einmal eingerichtet zu werden. Er verwandelt „bei jeder Kohorte Bulk Credentials manuell ausführen” in „Abschlüsse stellen bereits automatisch Credentials aus”, was die Version dieses Workflows ist, die die meisten Programmverantwortlichen nach dem zweiten oder dritten manuellen Stapel tatsächlich wollen.

Bereit, dein erstes verifizierbares Credential auszustellen? Starte kostenlos auf badges.ninja — visueller Designer, öffentliche Verifizierungsseite, PDF-Zertifikat, Open Badge v2.0 Ausgabe. Keine Kreditkarte erforderlich.