Bookeo to GroupList Integration Guide

Learn how to integrate Bookeo with GroupList using our webhook automation tool. Auto-subscribe clients after they book appointments.

Created: May 5, 2025
Last Updated: May 5, 2025
Developer: GroupList.io

Overview

This integration allows you to automatically subscribe clients to your GroupList mailing list when they book an appointment through Bookeo. Unlike other scheduling services, Bookeo requires using their API to set up webhooks, providing an enterprise-grade solution with robust message authentication.

Key Benefits:
  • Automatically add new clients to your email lists
  • Secure message authentication to prevent forgery
  • Support for various event types (new bookings, new customers, payments)
  • Works with all Bookeo business plans

Setup Instructions

Important: This integration requires creating a webhook in Bookeo via their API.

Step 1: Generate Your Webhook URL

  1. Go to the Bookeo to GroupList Webhook Generator tool
  2. Enter a name for your webhook (e.g., "Client Appointments")
  3. Enter your GroupList list ID
  4. Optionally enter your Bookeo application's secret key for message authentication
  5. Click "Generate Webhook URL"
  6. You'll receive your unique webhook URL to use with Bookeo's API

Step 2: Create a Webhook in Bookeo

Unlike other scheduling services, Bookeo requires you to create webhooks using their API. Here's how:

Option 1: Using cURL
curl -X POST \
https://api.bookeo.com/v2/webhooks \
-H 'Content-Type: application/json' \
-H 'X-Bookeo-apiKey: YOUR_BOOKEO_API_KEY' \
-d '{
  "domain": "bookings",
  "type": "created",
  "url": "YOUR_WEBHOOK_URL"
}'

Replace:

  • YOUR_BOOKEO_API_KEY with your actual Bookeo API key
  • YOUR_WEBHOOK_URL with the webhook URL from Step 1
Option 2: Using Bookeo's Developer Console
  1. Log in to your Bookeo account
  2. Go to System Settings → Integrations → API
  3. Access the Developer Console
  4. Create a new webhook with:
    • Domain: "bookings" (or "customers" for new customer events)
    • Type: "created"
    • URL: Your webhook URL from Step 1

How It Works

When a client books an appointment or a new customer is created in Bookeo:

  1. Bookeo sends a webhook notification to our system with the event details
  2. Our system validates the webhook message using Bookeo's signature headers
  3. Client information is extracted from the message payload
  4. The client is added to your specified GroupList list

The webhook processing is designed to be fast and reliable, responding to Bookeo within their 5-second timeout window while handling message authentication and duplicate detection.

Webhook Message Authentication:

Bookeo provides strong security for webhook messages through signature verification:

  1. Message Timestamp: Each message includes an X-Bookeo-Timestamp header, which our system verifies is within a reasonable time window (3 minutes)
  2. Message Signature: Each message includes an X-Bookeo-Signature header that we verify using your application's secret key

Supported Event Types

This integration supports multiple event types from Bookeo:

Booking Events
  • bookings/created: When a new booking is made
  • bookings/updated: When a booking is modified
  • bookings/deleted: When a booking is canceled
Customer Events
  • customers/created: When a new customer is added
  • customers/updated: When customer details are updated
Payment Events
  • payments/created: When a new payment is recorded

You can set up separate webhooks for each event type to trigger different actions in GroupList.

Troubleshooting

Common Issues and Solutions

Issue Solution
401 Unauthorized Check that your Bookeo secret key is correct
Message timestamp invalid Ensure your server's clock is synchronized
No email found in webhook data Check the data structure in your Bookeo webhook logs
404 Not Found Verify that your webhook URL is correctly configured in Bookeo
Duplicate webhook messages Our system automatically detects and ignores duplicates

Testing Your Integration

  1. Create a test booking in Bookeo
  2. Check your webhook logs for successful processing
  3. Verify that the client was added to your list

If a webhook message fails, Bookeo will automatically retry delivery several times with increasing intervals.

Frequently Asked Questions

Yes, you'll need a Bookeo API key to create webhooks through their API.

Yes, you can create separate webhooks for different event types (e.g., new bookings, new customers).

While not strictly required, we strongly recommend using message authentication for security.

Subscribers are added immediately when Bookeo sends the webhook notification.

Yes, Bookeo automatically retries failed webhook deliveries for up to 6 hours.

Related Articles

Using the GroupList.io API

Automate email list management and campaigns
Acuity Scheduling Integration

Connect Acuity Scheduling to GroupList
Launch Webhook Generator Back to Help Center
In This Article
Launch Webhook Generator