🚀 Jetzt neu: FlowAI! Ein revolutionärer Chat mit personalisierten AI-Agenten. 🌟

FlowContacts API - für persönliche Verbindungen

Eine moderne REST API zur Verwaltung von privaten Kontakten, Timeline-Einträgen und persönlichen Details. Perfekt für Integrationen, Daten-Synchronisation und individuelle Beziehungs-Management-Tools.

🔐 Schnellstart

Basis-URL: https://creativeskyline.de/api/flowcontacts/contacts
Pro-Abonnement erforderlich
Die FlowContacts API ist ausschließlich für Workspaces mit aktivem Pro-Abonnement verfügbar.

API-Zugangsdaten abrufen

Bevor Sie die API nutzen können, benötigen Sie Ihre persönlichen Zugangsdaten:

  1. Melden Sie sich in Ihrem Account an
  2. Navigieren Sie zu Profil → API-Zugang
  3. Ihr persönlicher API-Key (pk_...) ist dort direkt sichtbar und einsatzbereit

Authentifizierung

Alle API-Anfragen benötigen diese HTTP-Header:

Authorization: Bearer pk_dein_api_key\nAccept: application/json

📚 API-Referenz

Basis-URL: https://creativeskyline.de/api/flowcontacts/contacts

Kontakte auflisten

GET /api/flowcontacts/contacts

Ruft eine Liste Ihrer persönlichen Kontakte ab. Die Antwort enthält alle verknüpften Daten wie E-Mails, Telefonnummern und Adressen.

Query-Parameter:

status string Filter nach Status: active, archived, all
search string Suchbegriff (Name, Firma, Job, E-Mail)
per_page integer Anzahl der Ergebnisse (max 200)

Beispiel-Response:

{"success":true,"data":[{"uuid":"123e4567-e89b-12d3-a456-426614174000","first_name":"Max","last_name":"Mustermann","company":"Firma GmbH","emails":[{"id":1,"label":"Privat","email":"max@example.com","is_primary":true}],"timeline_entries":[]}],"meta":{"current_page":1,"per_page":15,"total":42}}

Kontakt-Details abrufen

GET /api/flowcontacts/contacts/{uuid}

Ruft die vollständigen Details eines einzelnen Kontakts ab, inklusive E-Mails, Telefonnummern, Adressen und Timeline-Einträgen.

Request Body:

uuid string * UUID des Kontakts (Pfad-Parameter)

Beispiel-Response:

{"success":true,"data":{"uuid":"123e4567-e89b-12d3-a456-426614174000","first_name":"Max","last_name":"Mustermann","company":"Firma GmbH","emails":[{"id":1,"label":"Privat","email":"max@example.com","is_primary":true}],"timeline_entries":[]}}

Kontakt erstellen oder aktualisieren

POST /api/flowcontacts/contacts

Erstellt einen neuen Kontakt oder aktualisiert einen bestehenden, wenn eine uuid im Body übergeben wird (Upsert-Semantik).

Request Body:

uuid string UUID für Update-Modus (weglassen für Neu-Anlage)
first_name string Vorname
last_name string Nachname
company string Firma
job_title string Berufsbezeichnung
emails array Array aus E-Mail-Objekten mit label, email und is_primary
phones array Array aus Telefon-Objekten mit label, phone und is_primary
timeline_entries array Array aus Timeline-Einträgen mit type, content und event_date

Beispiel-Response:

{"success":true,"data":{"uuid":"123e4567-e89b-12d3-a456-426614174000","first_name":"Erika","last_name":"Mustermann","company":null,"emails":[{"id":2,"label":"Geschäftlich","email":"erika@muster.de","is_primary":true}],"timeline_entries":[]}}

💻 Code-Beispiele

Basis-URL: https://creativeskyline.de/api/flowcontacts/contacts

Kompletten Kontakt anlegen

curl -X POST "BASE_URL/api/flowcontacts/contacts" \\n  -H "Authorization: Bearer pk_dein_api_key" \\n  -H "Content-Type: application/json" \\n  -d '{\n    "first_name": "Erika",\n    "last_name": "Mustermann",\n    "job_title": "Designerin",\n    "emails": [\n      { "label": "Geschäftlich", "email": "erika@muster.de" }\n    ]\n  }'