> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Signierte Webhook-Abonnements

> Registriere einen eigenen HTTPS-Empfänger für Anruf-, Gesprächs- und Buchungsereignisse.

Registriere einen eigenen HTTPS-Empfänger für Anruf-, Gesprächs- und Buchungsereignisse.

Workspace-Owner und Admins können Empfänger mit Settings: Write und der Leseberechtigung für die gewählten Ereignisse registrieren: Calls: Read oder Bookings: Read. API Access ist erforderlich. Signatur-Secrets bleiben beim Empfänger und werden weder beim Anlegen noch bei Listen- oder Detailabfragen zurückgegeben.

## Unterstützte Ereignisse

* `call.completed`
* `conversation.ended`
* `booking.created`
* `booking.cancelled`
* `booking.rescheduled`

Verwende im Empfänger ein starkes Signatur-Secret mit 16–256 Zeichen. Famulor signiert die exakten JSON-Bytes mit HMAC-SHA256 im Header X-Famulor-Signature. Prüfe die Signatur vor der Verarbeitung. Doppelte oder wiederholte Zustellungen sind möglich; verwende Ereignis und Ressourcen-ID zur Deduplizierung.

## n8n

Neue Famulor-Trigger-Nodes ab Paket 2.3.0 registrieren automatisch. Hinterlege Workspace-API-Key und Signatur-Secret in Famulor Webhook API, wähle ein Ereignis und aktiviere den Workflow. Die Deaktivierung entfernt nur das eigene Abonnement. Gespeicherte Version-2/3-Nodes bleiben manuell, bis du ausdrücklich Automatic Subscription auswählst. Bestehende Ziele von Assistants, Connectors und Buchungen bleiben erhalten.

## API, MCP, CLI und SDK

| REST | MCP | CLI |
| - | - | - |
| `GET /api/v1/webhooks` | `list_webhook_subscriptions` | `famulor list-webhook-subscriptions` |
| `POST /api/v1/webhooks` | `create_webhook_subscription` | `famulor create-webhook-subscription` |
| `GET /api/v1/webhooks/{id}` | `get_webhook_subscription` | `famulor get-webhook-subscription --id <subscription-id>` |
| `DELETE /api/v1/webhooks/{id}` | `delete_webhook_subscription` | `famulor delete-webhook-subscription --id <subscription-id>` |

```bash theme={null}
famulor create-webhook-subscription --url 'https://receiver.example.com/events' --events '["call.completed"]' --secret '<signing-secret-from-your-receiver>'
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

async function subscribe(workspaceApiKey: string, callbackUrl: string, signingSecret: string) {
const client = new Famulor({ apiKey: workspaceApiKey });
const subscription = await client.api.createWebhookSubscription({
  body: { url: callbackUrl, events: ['call.completed'], secret: signingSecret },
});
await client.api.deleteWebhookSubscription({ path: { id: subscription.data.id } });
}
```

Eine optionale, feste Abonnement-UUID macht die Wiederholung einer unklar bestätigten Registrierung mit identischen Einstellungen sicher. Andere Einstellungen für dieselbe ID liefern 409. Das Löschen eines bereits entfernten Abonnements liefert deleted: false.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.