FlowCRM API Dokumentation - Creative Skyline

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

Sicherheitshinweis: Behandeln Sie Ihre UUIDs wie Passwörter und teilen Sie sie niemals öffentlich.

3. Erste API-Anfrage

Testen Sie Ihre Verbindung mit diesem einfachen Beispiel:

curl -X GET "https://leads.creativeskyline.com/api/clients" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

📚 API-Referenz

Basis-URL: https://leads.creativeskyline.com/api/clients

🏢 Kunden-Verwaltung

GET /api/clients

Ruft eine Liste aller aktiven Kunden Ihres Teams ab.

GET /api/clients/search?search={term}

Durchsucht Ihre Kundendatenbank nach Name, Firmenname oder E-Mail-Adresse.

Parameter:

required search - Suchbegriff für die Kundensuche

📅 Timeline-Verwaltung

GET /api/clients/{uuid}/timeline

Ruft alle Timeline-Einträge für einen bestimmten Kunden chronologisch sortiert ab.

POST /api/clients/{uuid}/timeline

Erstellt einen neuen Timeline-Eintrag für den angegebenen Kunden.

Request Body:

{
  "title": "Titel des Eintrags",
  "content": "Inhalt des Eintrags (optional)",
  "event_date": "2024-01-01T10:00:00Z (optional, Standard: jetzt)"
}

GET /api/clients/{uuid}/timeline/search

Durchsucht die Timeline-Einträge eines Kunden nach Titel oder Inhalt.

📁 Projekt-Verwaltung

GET /api/clients/{uuid}/projects

Listet alle Projekte des angegebenen Kunden auf - inklusive Status, Beschreibung und einer modules-Array, das aktive Integrationen (flowcall, flowtime, flowtasks) enthält.

🗂️ Projekt-Timeline

GET /api/clients/{uuid}/projects/{project_uuid}/timeline

Ruft alle Timeline-Einträge für ein bestimmtes Projekt ab - analog zur Kunden-Timeline.

💻 Code-Beispiele

Timeline-Eintrag erstellen

curl -X POST "https://leads.creativeskyline.com/api/clients/{uuid}/timeline" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Neuer Eintrag",
    "content": "Beschreibung des Eintrags"
  }'

Kunden durchsuchen

curl -X GET "https://leads.creativeskyline.com/api/clients/search?search=Mustermann" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

Projekte abrufen

curl -X GET "https://leads.creativeskyline.com/api/clients/{uuid}/projects" \
  -H "X-Team-UUID: ihre-team-uuid" \
  -H "X-User-UUID: ihre-user-uuid" \
  -H "Accept: application/json"

Beispiel-Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Mustermann GmbH",
      "email": "info@mustermann.de",
      "phone": "+49 123 456789",
      "website": "https://mustermann.de",
      "currency": "EUR",
      "created_at": "2024-01-01T00:00:00.000000Z"
    }
  ],
  "count": 1
}

FlowCRM API für moderne CRM-Integrationen