Webhooks
Lassen Sie sich benachrichtigen, sobald ein Datensatz erstellt, aktualisiert oder gelöscht wird.
Webhooks senden eine HTTP-Anfrage an Ihr System, sobald sich Daten in Solid ändern, sodass Sie die API nie abfragen müssen.
Webhook erstellen
- Öffnen Sie Einstellungen → APIs & Webhooks → Webhooks.
- Klicken Sie auf + Webhook erstellen und geben Sie eine öffentliche HTTPS-URL ein.
- Klicken Sie auf Speichern. Ereignisse treffen ab sofort ein.
Ereignisse
| Ereignis | Beispiele |
|---|---|
| Datensatz erstellt | person.created, company.created |
| Datensatz aktualisiert | opportunity.updated |
| Datensatz gelöscht | company.deleted |
Payload
Jedes Ereignis ist ein POST mit einem JSON-Body:
{
"event": "person.created",
"data": {
"id": "abc12345",
"name": { "firstName": "Ana", "lastName": "Souza" },
"createdAt": "2026-09-30T15:30:45Z"
},
"timestamp": "2026-09-30T15:30:50Z"
}Antworten Sie mit einem beliebigen 2xx-Status, um die Zustellung zu bestätigen. Andere Antworten werden als Fehler protokolliert.
Signatur prüfen
Jede Anfrage ist signiert, damit Sie prüfen können, dass sie von Solid stammt. Die Header tragen die Namen der Open-Source-Engine, auf der Solid basiert:
| Header | Inhalt |
|---|---|
X-Twenty-Webhook-Signature | HMAC-SHA-256-Signatur |
X-Twenty-Webhook-Timestamp | Zeitpunkt der Signierung |
import crypto from 'node:crypto';
export function isFromSolid(req, secret) {
const timestamp = req.headers['x-twenty-webhook-timestamp'];
const expected = crypto
.createHmac('sha256', secret)
.update(`${timestamp}:${JSON.stringify(req.body)}`)
.digest('hex');
return expected === req.headers['x-twenty-webhook-signature'];
}Lehnen Sie Anfragen ab, deren Signatur nicht übereinstimmt, und ignorieren Sie Zeitstempel, die älter als einige Minuten sind, um Replay-Angriffe zu verhindern.