Overview
Receives Luma webhooks and inserts or updates rows for a connected event.
Endpoint
POST https://fluar.com/api/webhooks/luma/{teamId}
Your team UUID. It is included in the webhook URL when you connect a Luma event.
Event handling
| Event type | Action |
|---|
guest.registered | Create a row |
guest.updated | Update the existing row |
ticket.registered | Ignored (dedupe) |
Setup
- In Fluar, open the project and connect a Luma event in Settings.
- Enable the webhook for the event.
- Use the first column for payload data and create Reference columns.
Payload in the first column
Fluar stores a normalized guest payload in the first column. Example:
{
"api_id": "gst_abc123def456",
"user_email": "[email protected]",
"approval_status": "approved",
"registered_at": "2024-01-15T10:30:00Z",
"event_id": "evt_xyz789",
"event_name": "AI Summit 2024",
"guest": {
"api_id": "gst_abc123def456",
"email": "[email protected]",
"name": "John Doe",
"first_name": "John",
"last_name": "Doe"
}
}
Common JSON paths
| Field | JSON path |
|---|
| Email | guest.email |
| Full name | guest.name |
| First name | guest.first_name |
| Last name | guest.last_name |
| Guest ID | guest.api_id |
| Approval status | approval_status |
| Event name | event_name |
| Registered at | registered_at |
Deduplication and status
- Rows are deduped by
guest.api_id.
guest.updated updates the existing row.- If a column with ID
guest_status exists, it is set to approval_status.
Response
{
"success": true,
"matchedProjects": 1,
"rowsCreated": 1,
"rowsUpdated": 0
}
{
"error": "Missing teamId"
}
{
"error": "Invalid payload"
}
{
"metadata": {
"integration": "luma-event",
"luma": {
"eventId": "evt_xyz789",
"eventName": "AI Summit 2024",
"webhookEnabled": true,
"addApprovalColumn": true
}
}
}
| Setting | Required | Description |
|---|
luma.eventId | Yes | Luma event API ID |
luma.webhookEnabled | Yes | Must be true to process webhooks |
luma.eventName | No | Display name for the event |
luma.addApprovalColumn | No | Auto-create guest_status column |
Webhook requests are not signed. Keep the URL private and treat it as a secret.
