Flowella REST API: Authentifizierung, Scopes, Limits und Fehler

​

Basis-URL

https://api.flowella.io/v1

​

Authentifizierung

Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​

Zugangsdaten prüfen

curl https://api.flowella.io/v1/ping \
  -H "Authorization: Bearer $FLOWELLA_API_KEY"

const res = await fetch("https://api.flowella.io/v1/ping", {
  headers: { Authorization: `Bearer ${process.env.FLOWELLA_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://api.flowella.io/v1/ping",
    headers={"Authorization": f"Bearer {os.environ['FLOWELLA_API_KEY']}"},
)
print(res.json())

{
  "ok": true,
  "organizationId": 4821
}

​

Scopes

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "Token is missing required scope(s)",
    "requestId": "req_5b1e0c2a-8f3d-4e6a-9c7b-2d4f6a8e0b1c",
    "details": { "required": ["webhooks:manage"] }
  }
}

​

Fehler

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired API key"
  }
}

​

Ratenlimits

​

Anfrage-IDs

​

Idempotenz

​

Die meisten schreibenden Anfragen

• Der Schlüssel muss 8 bis 255 Zeichen lang sein. Andere Längen geben 400 zurück.
• Flowella merkt sich jeden Schlüssel für Ihre Organisation 24 Stunden lang.
• Eine Wiederholung mit demselben Schlüssel, derselben Methode, demselben Pfad und demselben Body gibt die gespeicherte Antwort zurück, ohne die Anfrage erneut auszuführen.
• Eine Wiederholung mit demselben Schlüssel, aber anderer Methode, anderem Pfad oder anderem Body gibt 409 IDEMPOTENCY_KEY_CONFLICT zurück.
• Eine Wiederholung, die gesendet wird, während die erste Anfrage noch läuft, gibt 409 IDEMPOTENCY_KEY_IN_FLIGHT zurück. Warten Sie und versuchen Sie es erneut.
• Antworten geben den Schlüssel in einem Header Idempotency-Key zurück.

​

Massenversand von Vorlagen

{
  "id": "v1ts-0123456789abcdef",
  "status": "accepted"
}

curl -X POST "https://api.flowella.io/v1/templates/send" \
  -H "Authorization: Bearer $FLOWELLA_API_KEY" \
  -H "Idempotency-Key: campaign-2026-08-31-launch" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
    "whatsappChannelId": "clxxxxxxxxxxxxxxxxxxxxxxxx",
    "recipients": [{ "phone": "+15551234567" }]
  }'

• Der Schlüssel kann bis zu 200 Zeichen lang sein. Ein längerer Schlüssel gibt 400 zurück.
• Eine Wiederholung mit demselben Schlüssel innerhalb von 7 Tagen gibt die ursprüngliche id zurück und sendet nichts, auch wenn sich der Body geändert hat.
• Ohne den Header verwendet Flowella einen Hash des Anfrage-Bodys als Schlüssel. Wenn Sie innerhalb von 7 Tagen erneut einen byte-identischen Body senden, erhalten Sie die ursprüngliche id zurück, und es wird nichts gesendet. Verwenden Sie für jeden Batch, den Sie senden möchten, einen neuen Schlüssel.

• Rufen Sie ihn mit einem API-Schlüssel auf. OAuth-Zugriffstoken werden mit 401 abgelehnt.
• Seine Antworten enthalten nicht die Header X-Request-Id, API-Version oder X-RateLimit-*. Seine Anfragen zählen trotzdem zum Ratenlimit des Schlüssels.

​

Versionierung

API-Version: 2026-08-11

​

Sandbox

• Mit einem Sandbox-Schlüssel, der nur Anfragen betrifft, die mit diesem Schlüssel gestellt werden. Siehe Sandbox-Schlüssel.
• Mit der organisationsweiten API-Sandbox im Developer Hub, die ein Owner oder Admin einschalten kann. Siehe API-Sandbox.

​

Paginierung

• Übergeben Sie limit (1 bis 100, Standard 25) und optional einen cursor.
• Die Antwort enthält items und, wenn es weitere Ergebnisse gibt, einen nextCursor.
• Übergeben Sie nextCursor als Parameter cursor, um die nächste Seite abzurufen.
• Wenn nextCursor fehlt oder null ist, haben Sie das Ende erreicht.

curl "https://api.flowella.io/v1/conversations?limit=50" \
  -H "Authorization: Bearer $FLOWELLA_API_KEY"

​

Datum und Uhrzeit

​

Telefonnummern

​

Kanäle

​

OpenAPI-Spezifikation

https://api.flowella.io/v1/openapi.json

​

Ressourcen für Entwickler