Um Kontakte programmatisch in großen Mengen zu erstellen und zu aktualisieren, verwendest du die REST-API von Papo. Mit der Authentifizierung über den geheimen Schlüssel (Bearer-Token) und den öffentlichen Schlüssel des Kontos kannst du Anfragen senden, die neue Datensätze einfügen oder bestehende Daten im CRM ändern – ideal, um externe Datenbestände zu synchronisieren, Listen zu migrieren oder die Kontaktdaten ohne manuelles Eingreifen stets aktuell zu halten.
Die Papo-API stellt Schreib-Endpunkte bereit, mit denen du einen Kontakt anlegen (mit Name, E‑Mail und/oder Telefonnummer) und einen bereits vorhandenen Kontakt aktualisieren kannst. In Kombination mit der einfachen Authentifizierung und dem JSON-Format ermöglichen diese Endpunkte Massenoperationen, wenn sie nacheinander durch Skripte, Automatisierungstools (wie n8n) oder individuelle Integrationen ausgeführt werden.
Überblick über den Integrationsprozess
| Schritt | Aktion | Wichtiges Detail |
|---|---|---|
| 1. Schlüssel erhalten | Den geheimen Schlüssel (sk_live_…) im Papo-Panel generieren und den öffentlichen Schlüssel (pk_live_…) kopieren. | Der geheime Schlüssel wird nur einmal angezeigt; bewahre ihn an einem sicheren Ort auf. |
| 2. Aufrufe authentifizieren | Den Header Authorization: Bearer sk_live_… in alle Schreibanfragen aufnehmen. |
Der öffentliche Schlüssel kann im Header X-Papo-Public-Key gesendet werden (optional). |
| 3. Payload vorbereiten | Ein JSON-Objekt mit den Feldern des Kontakts zusammenstellen (Name, E‑Mail, Telefon usw.). | Pflichtfelder und das genaue Format findest du in der API-Dokumentation. |
| 4. Anfragen senden | Ein POST an den Endpunkt zum Erstellen oder ein PUT/PATCH zum Aktualisieren ausführen. | Jede Anfrage verarbeitet einen Kontakt; bei vielen Datensätzen automatisiere das Senden in einer Schleife. |
| 5. Antworten prüfen | Die API gibt success: true und die Daten des erstellten/aktualisierten Kontakts zurück. |
Bei einem Fehler enthält der Body den Code und die Meldung zur Korrektur. |
Wie Authentifizierung und Endpunkte funktionieren
Jeder Aufruf, der Daten verändert (Erstellen, Aktualisieren), erfordert den geheimen Schlüssel des Kontos. Er muss als Bearer-Token im Header Authorization oder alternativ im Header X-Papo-Secret-Key gesendet werden. Der öffentliche Schlüssel (pro Konto fest) kann in der Anfrage im Header X-Papo-Public-Key mitgesendet werden – seine Verwendung ist optional, aber wenn er gesendet wird, muss er zum selben Konto wie der geheime Schlüssel gehören.
Die Basis-URL der API ist https://app.papo.global/api/v1. Ausgehend davon akzeptieren die Kontakt-Endpunkte die passenden HTTP-Verben, um einen neuen Datensatz zu erstellen oder einen bestehenden zu ändern. Da die vollständige Dokumentation die Pfade, Parameter und akzeptierten Felder im Detail beschreibt, empfehlen wir, vor dem Programmieren die offizielle API-Referenz zu konsultieren.
Beispiel für die Authentifizierung (Testanfrage)
Um zu prüfen, ob deine Schlüssel funktionieren, kannst du den Endpunkt GET /api/v1/me aufrufen, der die Kontodaten zurückgibt. Das Authentifizierungsmuster ist dasselbe wie bei allen anderen Endpunkten:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
Die erfolgreiche Antwort enthält success: true und das Objekt data mit den Informationen des Kontos. Danach musst du nur noch den Endpunkt und die HTTP-Methode je nach gewünschter Operation mit Kontakten austauschen.
Kontakte in großen Mengen erstellen und aktualisieren
Obwohl die API einen Kontakt pro Anfrage verarbeitet, erreichst du die Massenoperation, indem du mehrere Aufrufe nacheinander ausführst. Ein Skript in Python, Node.js oder eine Automatisierung in n8n kann:
- Eine Kontaktliste aus einer CSV-Datei, Datenbank oder einem ERP einlesen.
- Für jeden Datensatz den JSON-Payload mit den erforderlichen Feldern zusammenstellen.
- Die Anfrage an den Endpunkt zum Erstellen (falls der Kontakt nicht existiert) oder zum Aktualisieren (unter Verwendung der Kontakt-ID) senden.
- Die Antworten sammeln und eventuelle Fehler behandeln (doppelte E‑Mail, ungültiges Feld usw.).
Da die API REST-basiert ist und JSON verwendet, funktioniert jede Sprache mit HTTP-Unterstützung. Papo stellt außerdem Beispiele in JavaScript und Python auf der Dokumentationsseite bereit, die für die Kontakt-Endpunkte angepasst werden können.
Automatische Auslöser nach dem Erstellen
Immer wenn ein neuer Kontakt über die API erstellt wird, werden dieselben internen CRM-Ereignisse ausgelöst. Wenn du einen Flow mit dem Auslöser „Kontakt erstellt“ konfiguriert hast, wird die Automatisierung automatisch ausgeführt – zum Beispiel indem sie eine Willkommensnachricht über WhatsApp sendet oder das Vertriebsteam benachrichtigt. Das bedeutet, dass die Integration über die API nicht nur die Datenbank füllt, sondern auch die bereits im Konto vorhandenen Kommunikationsflüsse aktiviert.
Für wen diese Integration geeignet ist
- Unternehmen, die von einem anderen CRM oder einer Tabelle migrieren und Tausende von Kontakten auf einmal importieren müssen, während der Papo-Datenbestand synchron bleibt.
- Operationen, die Leads in externen Systemen erfassen (Landing Pages, ERPs, E‑Commerce) und möchten, dass diese automatisch im CRM von Papo landen, bereit für die Betreuung oder Kampagnen.
- IT-Teams, die individuelle Integrationen zwischen Papo und internen Tools erstellen und die API als Brücke nutzen, um Kundendaten stets aktuell zu halten.
- White-Label-Reseller, die mehrere Konten verwalten und die Kontakterstellung in großem Umfang für ihre Kunden automatisieren möchten.
Häufig gestellte Fragen
Brauche ich einen geheimen Schlüssel, um Kontakte zu erstellen oder zu aktualisieren?
Ja. Alle Schreiboperationen (Erstellen, Aktualisieren) erfordern die Authentifizierung mit dem geheimen Schlüssel des Kontos. Der öffentliche Schlüssel allein autorisiert keine Änderungen.
Kann ich Tausende von Kontakten auf einmal senden?
Die API verarbeitet einen Kontakt pro Anfrage. Bei großen Mengen musst du das sequenzielle Senden automatisieren und dabei die in der offiziellen Dokumentation beschriebenen Ratenlimits beachten.
Lösen über die API erstellte Kontakte den Flow „Kontakt erstellt“ aus?
Ja. Das Ereignis der Erstellung ist dasselbe, unabhängig von der Quelle. Wenn ein aktiver Flow mit diesem Auslöser vorhanden ist, wird er für jeden über die API eingefügten Kontakt ausgeführt.
Wie erkenne ich, ob ein Kontakt bereits existiert, um Duplikate zu vermeiden?
Du kannst vor dem Erstellen die Such-Endpunkte verwenden (gefiltert nach E‑Mail oder Telefon). Die API-Dokumentation beschreibt die verfügbaren Abfrageparameter im Detail.
Erlaubt es die API, nur einige Felder des Kontakts zu aktualisieren?
Ja. Sende im Body der Aktualisierungsanfrage nur die Felder, die du ändern möchtest. Die übrigen bleiben unverändert.
Wo finde ich die vollständige Liste der Endpunkte und Parameter?
Die vollständige Referenz ist auf der Dokumentationsseite der API verfügbar. Dort findest du die aktuellen Pfade, Methoden, Payloads und Beispiele.
Lies auch
- Wie du einen Flow automatisch auslöst, wenn ein neuer Kontakt im CRM erstellt wird
- Wie du im Extrator extrahierte Kontakte als CSV exportierst und in das CRM von Papo importierst
Starte kostenlos und binde dein CRM über die API an Papo an →
Mit dem ersten kostenlosen Nutzer kannst du bereits deine API-Schlüssel generieren und das Erstellen von Kontakten in großen Mengen ohne Anfangskosten testen.