Massenoperationen
Bis zu 1.000 Kontakte oder Teilnehmer auf einmal importieren.
Voraussetzungen
- Ein API-Schlüssel mit den erforderlichen Bereichen
- Ein aktiver PlanDocket-Account
Daten vorbereiten
Bereiten Sie Ihre Daten im JSON-Format vor. Der Massenimport unterstützt Kontakte und Teilnehmer mit bis zu 1.000 Datensätzen pro Anfrage. Sie können drei Modi verwenden: "create" (Standard, vorhandene überspringen), "update" (nur bestehende aktualisieren) oder "upsert" (anlegen oder aktualisieren). Der Abgleich erfolgt über "email" (Standard) oder "customer_number".
Kontakte importieren
Senden Sie Kontaktdaten an den Massenimport-Endpunkt. Verwenden Sie "mode" zur Steuerung des Anlege-/Aktualisierungsverhaltens, "match_field" zur Angabe des Abgleichfeldes und "skip_on_error" (Standard: true) um bei einzelnen Fehlern fortzufahren.
curl -X POST "https://your-tenant.plandocket.com/api/v1/bulk-import/contacts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "upsert",
"match_field": "email",
"skip_on_error": true,
"records": [
{"email": "john@example.com", "first_name": "John", "last_name": "Doe", "company_name": "Acme Inc"},
{"email": "jane@example.com", "first_name": "Jane", "last_name": "Smith", "company_name": "Beta Corp"}
]
}'Teilnehmer importieren
Importieren Sie Teilnehmer für ein bestimmtes Event. Geben Sie den "event_key" an, um Teilnehmer mit einem Event zu verknüpfen. Die Option "create_contacts" (Standard: true) legt automatisch Kontakte für noch nicht vorhandene Datensätze an. Setzen Sie den Wert auf false, um Datensätze ohne bestehenden Kontakt zu überspringen.
curl -X POST "https://your-tenant.plandocket.com/api/v1/bulk-import/participants" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_key": "expo-2025",
"mode": "create",
"match_field": "email",
"create_contacts": true,
"records": [
{"email": "john@example.com", "is_confirmed": true},
{"email": "jane@example.com", "is_confirmed": false}
]
}'