FlowContacts API Dokumentation

Navigation

🔐 Schnellstart

1. API-Zugangsdaten abrufen

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

Melden Sie sich in Ihrem Account an
Navigieren Sie zu Profil → API-Zugang
Kopieren Sie Ihre Team-UUID und Benutzer-UUID

🔑 Authentifizierung

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

X-Team-UUID: ihre-team-uuid-hier

X-User-UUID: ihre-benutzer-uuid-hier

Content-Type: application/json

3. Erste API-Anfrage

Testen Sie Ihre Verbindung mit diesem Beispiel:

curl -X GET "https://creativeskyline.de/api/flowcontacts/contacts" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

📚 API-Referenz

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

👥 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 - Filter nach Status (active, archived, all)

search - Suchbegriff (Name, Firma, Job, E-Mail)

per_page - Anzahl der Ergebnisse (max 200)

👤 Kontakt-Details

GET /api/flowcontacts/contacts/{uuid}

Ruft die vollständigen Details eines einzelnen Kontakts ab.

✍️ Kontakt erstellen oder aktualisieren

POST /api/flowcontacts/contacts

Erstellt einen neuen Kontakt oder aktualisiert einen bestehenden, wenn eine uuid im Body übergeben wird.

Request Body (Beispiel):

{
  "uuid": "optional-für-update",
  "first_name": "Max",
  "last_name": "Mustermann",
  "company": "Firma GmbH",
  "emails": [
    { "label": "Privat", "email": "max@example.com", "is_primary": true }
  ],
  "phones": [
    { "label": "Mobil", "phone": "+49123456789", "is_primary": true }
  ],
  "timeline_entries": [
    { "type": "note", "content": "Initialer Kontakt", "event_date": "2024-01-01T10:00:00Z" }
  ]
}

💻 Code-Beispiele

Kompletten Kontakt anlegen

curl -X POST "https://creativeskyline.de/api/flowcontacts/contacts" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Erika",
    "last_name": "Mustermann",
    "job_title": "Designerin",
    "emails": [
      { "label": "Geschäftlich", "email": "erika@muster.de" }
    ]
  }'

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": []
  }
}

FlowContacts API für persönliche Verbindungen