Event Email Notifications

Configure automated email notifications for booking events. Notifications are sent to attendees and hosts at various stages of the booking lifecycle.

Get Event Email Notifications

Retrieve all email notification templates configured for an event.

Endpoint

GET /calendars/{id}/events/{event_id}/email-notifications

URL Parameters

Parameter	Type	Required	Description
id	integer	Yes	The calendar ID
event_id	integer	Yes	The event ID

Response

Returns all notification templates with their settings.

{
    "notifications": {
        "booking_confirmed": {
            "enabled": true,
            "title": "Booking Confirmed (email to Attendee)",
            "email": {
                "subject": "Confirmed: {{booking.event_name}} at {{booking.start_date_time_for_attendee}}",
                "body": "<p>Your booking has been confirmed...</p>"
            }
        },
        "booking_confirmed_host": {
            "enabled": true,
            "is_host": true,
            "title": "Booking Confirmed (email to Organizer)",
            "email": {
                "additional_recipients": "",
                "subject": "New Booking: {{guest.full_name}} @ {{booking.start_date_time_for_host}}",
                "body": "<p>You have a new booking...</p>"
            }
        }
    }
}

Notification Types

The following notification types are available:

Type	Recipient	Description
booking_confirmed	Attendee	Sent when booking is confirmed
booking_confirmed_host	Organizer	Sent to host when booking is confirmed
cancelled_by_attendee	Organizer	Sent when attendee cancels
cancelled_by_host	Attendee	Sent when host cancels
rescheduled_by_attendee	Organizer	Sent when attendee reschedules
rescheduled_by_host	Attendee	Sent when host reschedules
booking_request_host	Organizer	Booking approval request (if approval required)
booking_request_attendee	Attendee	Booking submission confirmation
booking_reminder	Attendee	Reminder before meeting
booking_approved	Attendee	Sent when booking is approved
booking_rejected	Attendee	Sent when booking is rejected

Email Template Smart Codes

Use these placeholders in email templates:

Attendee Data

• {{guest.first_name}} - Guest first name
• {{guest.last_name}} - Guest last name
• {{guest.full_name}} - Guest full name
• {{guest.email}} - Guest email
• {{guest.note}} - Guest note
• {{booking.phone}} - Guest phone number
• {{guest.timezone}} - Guest timezone

Booking Data

• {{booking.event_name}} - Event name
• {{booking.description}} - Event description
• {{booking.booking_title}} - Booking title
• {{booking.full_start_end_guest_timezone}} - Full start date/time with guest timezone
• {{booking.full_start_end_host_timezone}} - Full start date/time with host timezone
• {{booking.location_details_text}} - Event location details
• {{booking.cancel_reason}} - Cancellation reason
• {{booking.reschedule_reason}} - Reschedule reason
• ##booking.cancelation_url## - Booking cancellation URL
• ##booking.reschedule_url## - Booking reschedule URL
• ##booking.admin_booking_url## - Admin booking details URL

Host Data

• {{host.name}} - Host name
• {{host.email}} - Host email
• {{host.timezone}} - Host timezone

Other

• {{event.title}} - Event title
• {{calendar.title}} - Calendar title
• {{add_booking_to_calendar}} - Add to calendar links

Update Event Email Notifications

Update email notification templates for an event.

Endpoint

POST /calendars/{id}/events/{event_id}/email-notifications

URL Parameters

Parameter	Type	Required	Description
id	integer	Yes	The calendar ID
event_id	integer	Yes	The event ID

Request Body

Parameter	Type	Required	Description
notifications	object	Yes	Object containing notification configurations

Example Request

{
    "notifications": {
        "booking_confirmed": {
            "enabled": true,
            "email": {
                "subject": "Booking Confirmed: {{booking.event_name}}",
                "body": "<p>Hi {{guest.first_name}},</p><p>Your booking is confirmed for {{booking.full_start_end_guest_timezone}}.</p>"
            }
        },
        "booking_reminder": {
            "enabled": true,
            "email": {
                "subject": "Reminder: Meeting in 1 hour",
                "body": "<p>This is a reminder about your upcoming meeting.</p>"
            }
        }
    }
}

Response

{
    "message": "Notifications have been saved"
}

Clone Event Email Notifications

Copy email notification templates from another event.

Endpoint

POST /calendars/{id}/events/{event_id}/email-notifications/clone

URL Parameters

Parameter	Type	Required	Description
id	integer	Yes	The calendar ID
event_id	integer	Yes	The target event ID

Request Body

Parameter	Type	Required	Description
from_event_id	integer	Yes	The event ID to copy notifications from

Response

{
    "message": "The Notification has been cloned successfully",
    "notifications": {
        ...
    }
}

Related Resources

• Calendar Events