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 schaltet Core API und Webhooks frei.
Ohne ProPass: api_access_plus für die Core API, zusätzlich webhooks_access für Webhooks.
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
API + Webhooks Add-ons
Automationen, Sync-Jobs, Plattformen ohne ProPass
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 (Auswahl)
Base URL: https://api.crewio.co/api/developer/v1/. Vollständige Reference inklusive Request/Response-Schemas in der detaillierten Doku.
/events
events:read
events:read
Events listen
Gate: ProPass
/events
events:create
events:create
Event anlegen
Gate: ProPass
/events/sync
events:write
events:write
Events synchronisieren
Gate: ProPass
/helpers
helpers:write
helpers:write
Helfer bulk anlegen oder synchronisieren
Gate: ProPass
/events/{eventId}/assignments
assignments:write
assignments:write
Zuweisung anlegen oder Status setzen
Gate: ProPass
/events/{eventId}/messages
messages:write
messages:write
Nachricht erstellen / Broadcast auslösen
Gate: ProPass
/webhooks
webhooks:write
webhooks:write
Webhook erstellen
Gate: Pro oder Add-ons
/webhooks/deliveries
webhooks:read
webhooks:read
Delivery-Logs lesen
Gate: Pro oder Add-ons
/automations/workflows
automation:write
automation:write
Workflow anlegen
Gate: ProPass
/automations/trigger
automation:write
automation:write
Automation manuell auslösen
Gate: ProPass
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.