Webhook Transforms

Contract

This skill guarantees:

• External events are transformed into brain pages with proper citations
• Raw payloads are preserved (dead-letter queue if transform fails)
• Entity extraction runs on every transformed event
• Input sanitization: no raw HTML/script passes to brain pages
• Error handling: transform failure logs raw payload, retries once

Phases

1. Define transform. Map event schema to brain page format:

   • Input: raw webhook payload (JSON)
   • Output: brain page content (markdown) + metadata (slug, type, citations)
   • Must sanitize: strip HTML tags, escape script content

2. Register webhook URL. Provide the external service with the webhook endpoint.