Webhook Event Reference

Filoxenos sends a common envelope for all webhook events. The event-specific data is contained within the data object.

Payload Envelope

Common Format

json

{
  "event": "string",
  "timestamp": "ISO 8601",
  "webhook_id": "whk_...",
  "delivery_attempt": 1,
  "data": {
    "...": "..."
  }
}

HTTP Headers

X-Filoxenos-Signature: sha256=...

X-Filoxenos-Event: checkin.completed

X-Filoxenos-Delivery: dlv_...

X-Filoxenos-Timestamp: 1672531200

Check-In Events

checkin.completed

Real-time

Fired when a guest completes the digital check-in form.

Use Case: → Send WhatsApp welcome message via Twilio

Payload Example

json

{
  "event": "checkin.completed",
  "timestamp": "2026-04-09T18:22:00Z",
  "webhook_id": "whk_123456",
  "data": {
    "checkin_id": "chk_556677",
    "booking_id": "book_abc123",
    "property_id": "prop_12345",
    "guest_name": "Konstantinos Theodorou",
    "nationality": "GR"
  }
}

checkin.overdue

Scheduled (09:00)

Fired daily if a guest is arriving within 24h and hasn't completed their check-in.

Use Case: → Send reminder SMS to host or guest

Payload Example

json

{
  "event": "checkin.overdue",
  "timestamp": "2026-04-09T09:00:00Z",
  "data": {
    "checkin_id": "chk_998877",
    "booking_id": "book_xyz789",
    "arrival_date": "2026-04-10"
  }
}

Guest Events

guest.departure

Scheduled (08:00)

Fired on the morning of checkout. Helpful for coordination with cleaning staff.

Use Case: → Notify cleaning team and send checkout instructions to guest

Payload Example

json

{
  "event": "guest.departure",
  "timestamp": "2026-04-09T08:00:00Z",
  "data": {
    "property_id": "prop_12345",
    "booking_id": "book_abc123",
    "next_arrival": "2026-04-09T15:00:00Z"
  }
}

Report Events

report.ready

Real-time

Fired when a monthly or annual AADE report has finished generating.

Payload Example

json

{
  "event": "report.ready",
  "timestamp": "2026-04-09T10:30:00Z",
  "data": {
    "report_id": "rep_2026_05",
    "period": "2026-05",
    "download_url": "https://docs.filoxenos.gr/reports/..."
  }
}

And many more...

This page highlights the most common events. See the full SDK documentation for events like report.gaps_detected, sync.completed, deadline.approaching, and takk.season_change.