Übersicht
Erstellen Sie einen einzelnen Kontaktdatensatz. Alle drei Body-Felder sind Pflicht. Telefonnummern sollten in vielen Integrationen die Ländervorwahl ohne führendes Plus enthalten — validieren Sie nach Ihren lokalen Regeln. Nach der Erstellung verwenden Sie die Kontakt-ID in WhatsApp-Sendungen über contact_id.
POST /api/contacts/
Rufen Sie diesen Endpunkt mit POST und gültigem Bearer-Token auf.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane", "lastname": "Doe", "number": "21690123456"}'Hinweise zur Nutzung
Einzelnen Kontakt anlegen. Alle drei Body-Felder Pflicht. Nummern mit Ländervorwahl. Nach Erstellung contact_id für WhatsApp-Sends nutzen.
Nutzen Sie Paginierung und Filter, um die Antwortgröße zu reduzieren.
Integrationshinweise
Bei der Integration dieses Buzzbip-Endpunkts https://app.buzzbip.com als Produktionshost verwenden. JWT über POST /api/login_check holen und Authorization: Bearer mitsenden. User.hasApiAccess im Buzzbip-Admin muss aktiv sein. JSend-Antworten (status, message, data) auswerten. Für E-Commerce-Plugins zusätzlich x-api-key, x-platform-type und x-base-uri senden. Abschließende Slashes bei POST /api/contacts/ und POST /api/whatsapp/ beachten. Bei Ratenlimits Backoff-Retries implementieren. Zugangsdaten serverseitig speichern und vor JWT-Ablauf (3600 s) neu authentifizieren.
Sicherheit
Sicherheit: Zugangsdaten nur serverseitig, TLS Pflicht, fehlgeschlagene Auth überwachen. Staging- und Produktionskonten trennen. Vorlagen und Automationen dokumentieren. Nummern und Inhalte in geteilten Logs schwärzen.
Wie geht es weiter?
Verwandte Seiten: api/contacts/list-contacts api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm
