Acuity to GroupList Integration Guide

This integration allows you to automatically subscribe clients to your GroupList mailing list when they book an appointment through Acuity Scheduling. The integration works through a combination of webhooks and custom conversion tracking, ensuring that both appointment notifications and client contact information are properly captured.

Step 1: Generate Your Webhook URL

1. Go to the Acuity to GroupList Webhook Generator tool
2. Enter a name for your webhook (e.g., "Client Appointments")
3. Enter your GroupList list ID
4. Click "Generate Webhook URL"
5. You'll receive two important pieces of information:
   • Your webhook URL
   • Custom conversion tracking code

Step 2: Set Up Acuity Webhooks

1. Log in to your Acuity Scheduling account
2. Go to Business Settings → Integrations → Webhooks
3. In the "New Appointment Scheduled" field, paste your webhook URL
4. Click "Save"

Step 3: Set Up Custom Conversion Tracking

1. In your Acuity account, go to Business Settings → Integrations → Custom Conversion Tracking
2. Copy and paste the JavaScript code provided by the webhook generator
3. This code should look similar to:
   <script type="text/javascript">
window.top.location = 'https://grouplist.io/integrations/acuity/app.php?webhook=YOUR_WEBHOOK_ID&email=%email%&firstName=%firstName%&lastName=%lastName%&id=%id%';
</script>
4. Click "Save Settings"

This integration uses two methods to ensure all client data is captured properly:

1. Webhooks: When a client books an appointment, Acuity sends a notification to our system
2. Custom Conversion Tracking: After booking, the client is briefly redirected to our system to capture their contact information

The combination of these two methods ensures that all necessary client information is collected and properly added to your GroupList list.

Multiple Lists

You can create multiple webhooks to send clients to different GroupList lists based on appointment type:

1. Create a separate webhook for each list
2. In Acuity, set up custom appointment scheduling links for each appointment type
3. Add the custom conversion tracking code to each link

Additional Client Information

The integration captures:

• Email address
• First name
• Last name
• Appointment ID

If you need additional client information in GroupList, contact us for custom work.

Common Issues and Solutions

Testing Your Integration

1. Create a test booking in Acuity using your own email
2. Check your webhook logs for successful processing
3. Verify that your email was added to your GroupList list

If you're experiencing issues, you can view detailed logs in the webhook management page.