Skip to content

⚡ Manage Webhook Subscriptions

For LIKE MAGIC Account Admins: Setting up real-time event notifications

What Are Webhook Subscriptions?

Webhook subscriptions are real-time event notifications that automatically push data to your application when something happens. Instead of constantly polling our APIs to check for updates, webhooks deliver events instantly to your system. They're perfect for:

✅ Real-time synchronization with external systems
✅ Triggering automated workflows
✅ Building event-driven architectures
✅ Reducing API calls and improving efficiency
✅ Getting instant notifications of critical events

Think of webhooks as push notifications for your applications - we call you when something happens, instead of you constantly asking us if anything changed.

Who Can Manage Webhook Subscriptions?

Only users with the Account Admin role can create, edit and delete webhook subscriptions through the Operational Platform.

🎯 Not an Account Admin? Contact your LIKE MAGIC Account Admin to request access.

Creating a Webhook Subscription

Step 1: Access Webhook Subscriptions

  1. Log into the Operational Platform
  2. Navigate to Settings → Webhooks
  3. Click + New Webhook Subscription

Step 2: Configure Details

Fill in the webhook subscription details:

New Webhook Subscription

Webhook Name

Human-friendly description to identify this webhook

URL callback

The HTTPS endpoint where we'll send event notifications

✅ https://api.yourapp.com/webhooks/likemagic
✅ https://webhook-consumer.example.com/callback
❌ http://insecure.com/webhook (must use HTTPS!)
❌ localhost:3000/webhook (must be publicly accessible)

Requirements:

  • Must use HTTPS (for security)
  • Must be publicly accessible
  • Must respond within 5 seconds
  • Should return 2xx status code for success

💡 Pro Tip: Set up a dedicated webhook endpoint that can handle high volumes and has proper error handling.

Secret

Shared secret for webhook signature verification

The system generates a secure random secret automatically. Use this to verify that webhook calls actually come from LIKE MAGIC.

✅ Store this secret securely (env variables, secret manager)
✅ Use it to validate webhook signatures
✅ Regenerate if compromised
❌ Never expose in logs or error messages

Apply to the following properties

Filter which properties trigger this webhook

  • No selection (default): Webhook receives events from all properties
  • Select specific properties: Only events from selected properties trigger this webhook

Step 3: Select Topics

Topics define which events trigger your webhook. Select only the events you need!

Select Topics

Available Topics

Each Business Event in the platform defines its own topic. Topics are organized by domain and follow a consistent naming pattern.

Browse the complete catalog of available topics in the Business Events documentation:

  • Guest Journey - Reservation lifecycle, check-in/out flows, bookings, folios
  • Communication - Conversations and messages
  • Identity - Guest profiles and accounts
  • Operations - Tasks, units, locks and gateways

Popular Topics:

  • RESERVATION_CHECKED_IN, RESERVATION_CHECKED_OUT
  • TASK_CREATED, TASK_COMPLETED
  • MESSAGE_RECEIVED, MESSAGE_SENT
  • PROFILE_CREATED, PROFILE_UPDATED

👉 See Business Events for the complete list of available topics and their event structures.

Step 4: Save

Save Webhook Subscription

Remember

Webhooks are powerful real-time integrations. Implement proper security, error handling and monitoring to build reliable webhook consumers! ⚡