getaero-io/gtm-eng-skills / drafts/luma-inbound-webhook-enrich
luma-inbound-webhook-enrich
VerifiedDRAFT. Design and harden a standing Luma registration/unsubscribe webhook that enriches guests and writes to CRM or customer DB — with backfill and versioning. Not installed by deepline skills.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.7 KB |
| references/field-map.md | markdown | 2.6 KB |
| templates/play-sketch.json | config | 2.8 KB |
references/field-map.md
View on GitHub# CRM Field Mapping Reference
## Standard fields (typical CRM/DB schema)
| Luma field | CRM field | Notes |
| --- | --- | --- |
| `guest.email` | `email` | Primary key for upsert |
| `guest.name` | `full_name` or split to `first_name` + `last_name` | Normalize capitalization |
| `event.name` | `event_registered` | Store event name or ID |
| `registration.timestamp` | `event_registration_date` | ISO 8601 |
| `registration.status` | `event_status` | pending / approved / waitlist / cancelled |
## Enriched fields (from Deepline or other providers)
| Enrichment | CRM field | Provider |
| --- | --- | --- |
| LinkedIn profile URL | `linkedin_url` | Deepline, PDL, LeadMagic |
| Job title | `title` | LinkedIn via Deepline |
| Company name | `company` | LinkedIn via Deepline |
| Company domain | `company_domain` | Enrichment or normalized from email |
| Company size | `company_employee_count` | Crustdata, PDL |
| Company industry | `company_industry` | Crustdata, PDL |
| Email validation | `email_valid` | Hunter, ZeroBounce, Prospeo |
| Email deliverability | `email_deliverable` | Hunter, ZeroBounce |
## Segment/scoring fields
| Field | Type | Notes |
| --- | --- | --- |
| `icp_segment` | hot / warm / low / skip | From scoring logic |
| `tal_match` | boolean | True if company in target account list |
| `icp_score` | 0-100 | Composite score |
## Event-specific fields
| Field | Type | Notes |
| --- | --- | --- |
| `event_checked_in` | boolean | Updated day-of or via webhook |
| `event_no_show` | boolean | Updated post-event |
| `event_feedback_submitted` | boolean | If post-event survey exists |
## Optional: lifecycle tracking
| Field | Type | Notes |
| --- | --- | --- |
| `first_event_date` | date | First event registration |
| `total_events_registered` | integer | Count of registrations |
| `total_events_attended` | integer | Count of check-ins |
## Webhook versioning
When updating field mappings:
1. Bump workflow/play version (e.g. `v1` → `v2`)
2. Document changes in a `CHANGELOG.md`
3. Test on a dry-run branch before deploying to prod
4. Consider backfilling historical records if critical fields changed
## Secrets / env vars
Never hardcode in SKILL.md or public repos. Keep these references in tracked JSON; bind values through deployment tooling and a secret store in the private apply payload, and never commit that rendered payload. Use:
- `${HUBSPOT_PORTAL_ID}` — HubSpot portal ID
- `${HUBSPOT_API_KEY}` — HubSpot private app token
- `${ATTIO_WORKSPACE_ID}` — Attio workspace ID
- `${ATTIO_API_KEY}` — Attio API key
- `${LUMA_WEBHOOK_SECRET}` — Luma webhook signing secret
- `${SLACK_WEBHOOK_URL}` — Slack incoming webhook for notifications
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |