Developer API für CREWIO
Integrationen schneller starten
Verbinde CREWIO mit Formularen, CRM, Kalendern und Automationen. Scopes, Pay-Gates und Webhooks sind auf produktive Vereinsprozesse ausgelegt.
Was Nutzer zuerst wissen müssen
Die wichtigsten Entscheidungen vor der ersten Zeile Code.
Free hat keinen API-Zugriff.
ProPass reicht für Events, Helfer, Schichten und Nachrichten.
Developer API Add-on wird für Delivery-Logs und Automationen benötigt.
Start
Drei Schritte bis zur ersten Integration
Die Seite führt nicht durch jedes Detail auf einmal. Erst Zugriff, dann Key, dann ein kleiner produktiver Test.
Zugriff aktivieren
ProPass oder Developer API Add-on im Verein buchen.
Integration anlegen
App im Dashboard erstellen und benötigte Scopes auswählen.
Live testen
Event anlegen, Helfer importieren oder Webhook empfangen.
Zugriff
Welcher Plan passt?
Die Pay-Gates sind absichtlich eindeutig: Nutzer sehen früh, ob ein Upgrade oder Add-on nötig ist.
Free
Manuelle Eventplanung
ProPass
CRM, Formulare, Helferimport
Developer API Add-on
Automationen, Sync-Jobs, Plattformen
Use Cases
Wofür Teams die API nutzen
Die wichtigsten Einstiege sind als konkrete Aufgaben formuliert, nicht als technische Feature-Liste.
Helfer importieren
Formulare, CRM oder Tabellen mit CREWIO synchronisieren.
Events spiegeln
Externe Kalender oder Vereinssoftware mit Events abgleichen.
Schichten besetzen
Zuweisungen aus externen Tools erstellen und aktualisieren.
Broadcasts auslösen
Reminder, SMS, WhatsApp und Event-Nachrichten automatisieren.
Event-Day anbinden
Check-in und Live-Status in operative Systeme übernehmen.
Webhooks nutzen
Änderungen zuverlässig in eigene Systeme pushen lassen.
Beispiele
Kleine Tests statt langer Integration
Zwei kurze Snippets decken die häufigsten Einstiege ab: Event anlegen und Helfer importieren.
Event per API anlegen
Minimaler Test für Key, Scope und Event-Limit.
curl -X POST 'https://api.crewio.co/api/developer/v1/events' \
-H 'Authorization: Bearer crw_live_...' \
-H 'Content-Type: application/json' \
-d '{
"name": "Sommerfest 2026",
"start_date": "2026-08-20",
"end_date": "2026-08-21",
"status": "draft"
}'Helfer importieren
Typischer Einstieg aus Formular, CRM oder CSV-Pipeline.
const response = await fetch('https://api.crewio.co/api/developer/v1/helpers', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.CREWIO_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
mode: 'import',
sync_to_event_id: 'event-uuid',
helpers: [
{ full_name: 'Max Muster', email: 'max@example.org', tags: ['bar'] },
{ full_name: 'Nora Team', phone: '+49177111222', tags: ['kasse'] },
],
}),
})
const payload = await response.json()
if (!response.ok) throw new Error(payload.error || 'Import failed')API
Core-Endpunkte
Base URL: https://api.crewio.co/api/developer/v1/
/events
events:read
events:read
Events lesen, filtern und paginieren.
Gate: ProPass
/events
events:create
events:create
Event erstellen. Event-Limits werden serverseitig geprüft.
Gate: ProPass
/events/sync
events:write
events:write
Events per Bulk-Create/Update synchronisieren.
Gate: ProPass
/helpers
helpers:write
helpers:write
Helfer importieren und optional Event-Zugriff synchronisieren.
Gate: ProPass
/events/{eventId}/assignments
assignments:write
assignments:write
Schichtzuweisungen erstellen und Status ändern.
Gate: ProPass
/events/{eventId}/messages
messages:write
messages:write
Nachrichten und Broadcasts auslösen.
Gate: ProPass
/webhooks
webhooks:write
webhooks:write
Webhook-Endpunkte mit Signing Secret konfigurieren.
Gate: Developer API Add-on
/webhooks/deliveries
webhooks:read
webhooks:read
Delivery-Logs, Statuscodes und Retry-Ergebnisse lesen.
Gate: Developer API Add-on
/automations/workflows
automation:write
automation:write
Automation-Workflows per API anlegen.
Gate: Developer API Add-on
/automations/trigger
automation:write
automation:write
Event-basierte Automation über API auslösen.
Gate: Developer API Add-on
Webhooks
Signierte Events mit Retry
CREWIO sendet Webhooks mit Signatur, Statuscodes und nachvollziehbaren Delivery-Logs im Add-on.
Signatur prüfen
Serverseitig immer mit dem Roh-Body prüfen.
import crypto from 'node:crypto'
function verifyCrewioSignature(rawBody, signatureHeader, secret) {
const provided = String(signatureHeader || '').replace(/^sha256=/i, '').trim()
if (!/^[a-f0-9]{64}$/i.test(provided)) return false
const expected = crypto.createHmac('sha256', secret).update(rawBody, 'utf8').digest('hex')
return crypto.timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(provided, 'hex'))
}Ressourcen
Alles, was Nutzer nach dem Einstieg wirklich brauchen.