# Quickstart

Das erste Event senden und im Dashboard prüfen.

## Voraussetzungen

Du benötigst ein bestehendes Projekt, dessen Slug und einen aktiven API-Token dieses Projekts. Bewahre den Token auf deinem Server als Umgebungsvariable `TRACKLYTIC_API_TOKEN` auf.

## Event senden

Ersetze `my-project` durch deinen Projekt-Slug. Der Kanal `deployments` wird bei Bedarf angelegt.

```bash
curl -X POST 'https://api.tracklytic.de/v1/event' \
  -H "Authorization: Bearer $TRACKLYTIC_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "project": "my-project",
  "channel": "deployments",
  "event": "Deployment abgeschlossen",
  "tags": {
    "version": "2.4.0",
    "environment": "production"
  },
  "notify": false
}'
```

Die API antwortet mit HTTP `201` und `{}`. Das ist die vollständige Erstellungsantwort eines normalen Events. Öffne anschließend das Projekt und den Kanal im Dashboard.

## Nutzer zuordnen

Mit `userId` verbindest du Events mit einem Nutzerprofil. Verwende für [Identify](/api/identify) denselben stabilen Bezeichner, beispielsweise eine interne Kunden-ID. Ein Profil ist kein Tracklytic-Login.

## Weitere Felder

Der [Event-Generator](/docs/guides/event-builder) ergänzt Tags, Badge, Logs, Links, Buttons, Formulare und Pipeline-Steps. Die [Feldreferenz](/api/create-event) beschreibt alle Event-Felder.

## Fehler prüfen

Bei `400` prüfe die Feldtypen und Slugs, bei `401` den Token und bei `403` dessen Projektzuordnung. Weitere Fälle stehen unter [Fehler](/api/errors).