> ## Documentation Index
> Fetch the complete documentation index at: https://help.lunacal.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Webhooks
> Webhooks can let your integrations take an action in response to events that occur on Lunacal.ai. This document will guide you through adding webhooks.
## **Step 1**
Start by opening the event type you want to configure.
## **Step 2**
Proceed by clicking on the “Advaced” tab and click on button to add “New Webhook”.
## **Step 3**
You can create webhooks to subscribe to specific events on Lunacal. The **Subscriber URL** should point to your API endpoint that will receive HTTP requests from our platform. If you our new to webhooks you can use API from [webhook.site](http://webhook.site) to try these webhooks.
Lunacal currently supports the following webhook events:
1. **Booking Created** — Triggered when a new booking is created by any user.
2. **Booking Cancelled** — Triggered when a booking is cancelled.
3. **Booking Rescheduled** — Triggered when an existing booking is rescheduled.
4. **Booking Requested** — Triggered when a booking is created but requires organizer approval before confirmation.
5. **Booking Rejected** — Triggered when a booking request is rejected by the organizer.
6. **Booking Payment Initiated** — Triggered when a user initiates a payment for a paid event.
7. **Booking Paid** — Triggered after successful payment for a booking.
## **Step 4**
You can test your webhook using the **Ping Test** button. This will send sample data to your webhook endpoint to verify that it’s functioning properly. If everything is set up correctly, you will receive a `200 OK` response with the following payload:
```
{ "ok": true, "status": 200, "message": "Webhook received" }
```
## Response Format and Fields
```json BOOKING_CREATED theme={null}
{
"triggerEvent": "BOOKING_CREATED",
"createdAt": "2025-07-02T07:14:48.795Z",
"payload": {
"bookerUrl": "https://lunacal.ai",
"type": "quint",
"title": "quick chat between Ayush Gupta and Anupam.",
"description": "",
"additionalNotes": "",
"customInputs": {},
"startTime": "2025-07-16T23:30:00Z",
"endTime": "2025-07-17T00:00:00Z",
"organizer": {
"id": 584,
"name": "Ayush Gupta",
"email": "ayush4002gupta@gmail.com",
"username": "ayush-gupta-57m",
"timeZone": "Asia/Srednekolymsk",
"language": {
"locale": "en"
},
"timeFormat": "h:mma",
"utcOffset": 660
},
"responses": {
"name": {
"label": "your_name",
"value": "Anupam",
"isHidden": false
},
"email": {
"label": "email_address",
"value": "anupam@lunacal.onmicrosoft.com",
"isHidden": false
},
"location": {
"label": "location",
"isHidden": false
},
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"userFieldsResponses": {
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"attendees": [
{
"email": "anupam@lunacal.onmicrosoft.com",
"name": "Anupam",
"firstName": "",
"lastName": "",
"timeZone": "Asia/Tashkent",
"language": {
"locale": "en"
},
"utcOffset": 300
}
],
"location": "",
"destinationCalendar": null,
"hideCalendarNotes": false,
"requiresConfirmation": false,
"eventTypeId": 975,
"seatsShowAttendees": true,
"seatsPerTimeSlot": null,
"seatsShowAvailabilityCount": true,
"schedulingType": null,
"iCalUID": "r543Dk3BeyfTafREgkSU8v@Lunacal.ai",
"iCalSequence": 0,
"uid": "r543Dk3BeyfTafREgkSU8v",
"eventTitle": "quick chat",
"eventDescription": "",
"price": 0,
"currency": "usd",
"length": 30,
"bookingId": 3899,
"metadata": {},
"status": "ACCEPTED"
}
}
```
```json BOOKING_CANCELLED theme={null}
{
"triggerEvent": "BOOKING_CANCELLED",
"createdAt": "2025-07-02T07:19:25.308Z",
"payload": {
"title": "quick chat between Ayush Gupta and Anupam.",
"type": "quick chat",
"customInputs": {},
"eventTypeId": 975,
"userFieldsResponses": {
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"responses": {
"name": {
"label": "your_name",
"value": "Anupam",
"isHidden": false
},
"email": {
"label": "email_address",
"value": "anupam@lunacal.onmicrosoft.com",
"isHidden": false
},
"location": {
"label": "location",
"isHidden": false
},
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"startTime": "2025-07-18T00:00:00+00:00",
"endTime": "2025-07-18T00:30:00+00:00",
"organizer": {
"id": 584,
"username": "ayush-gupta-57m",
"email": "ayush4002gupta@gmail.com",
"name": "Ayush Gupta",
"timeZone": "Asia/Srednekolymsk",
"timeFormat": "h:mma",
"language": {
"locale": "en"
},
"utcOffset": 660
},
"attendees": [
{
"name": "Anupam",
"email": "anupam@lunacal.onmicrosoft.com",
"timeZone": "Asia/Tashkent",
"language": {
"locale": "en"
},
"utcOffset": 300
}
],
"uid": "tzaCPKTHa9TMpGvpbFc4Rm",
"bookingId": 3901,
"location": "",
"destinationCalendar": [],
"cancellationReason": "some urgent work needs to be taken care of",
"team": {
"name": "Nameless",
"members": []
},
"seatsPerTimeSlot": null,
"seatsShowAttendees": false,
"iCalUID": "tzaCPKTHa9TMpGvpbFc4Rm@Lunacal.ai",
"iCalSequence": 1,
"eventTitle": "quick chat",
"eventDescription": null,
"requiresConfirmation": null,
"price": null,
"currency": "usd",
"length": 30,
"status": "CANCELLED"
}
}
```
```json BOOKING_RESCHEDULED theme={null}
{
"triggerEvent": "BOOKING_RESCHEDULED",
"createdAt": "2025-07-02T07:15:53.255Z",
"payload": {
"bookerUrl": "https://lunacal.ai",
"type": "quint",
"title": "quick chat between Ayush Gupta and Anupam.",
"description": "",
"additionalNotes": "",
"customInputs": {},
"startTime": "2025-07-25T00:00:00Z",
"endTime": "2025-07-25T00:30:00Z",
"organizer": {
"id": 584,
"name": "Ayush Gupta",
"email": "ayush4002gupta@gmail.com",
"username": "ayush-gupta-57m",
"timeZone": "Asia/Srednekolymsk",
"language": {
"locale": "en"
},
"timeFormat": "h:mma",
"utcOffset": 660
},
"responses": {
"name": {
"label": "your_name",
"value": "Anupam",
"isHidden": false
},
"email": {
"label": "email_address",
"value": "anupam@lunacal.onmicrosoft.com",
"isHidden": false
},
"location": {
"label": "location",
"isHidden": false
},
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"userFieldsResponses": {
"Please-share-anything-that-will-help-prepare-for-our-meeting-": {
"label": "Please share anything that will help prepare for our meeting.",
"isHidden": true
},
"guests": {
"label": "Add Guests",
"value": [],
"isHidden": false
}
},
"attendees": [
{
"email": "anupam@lunacal.onmicrosoft.com",
"name": "Anupam",
"firstName": "",
"lastName": "",
"timeZone": "Asia/Tashkent",
"language": {
"locale": "en"
},
"utcOffset": 300
}
],
"location": "",
"destinationCalendar": null,
"hideCalendarNotes": false,
"requiresConfirmation": false,
"eventTypeId": 975,
"seatsShowAttendees": true,
"seatsPerTimeSlot": null,
"seatsShowAvailabilityCount": true,
"schedulingType": null,
"iCalSequence": 1,
"uid": "kqYN7oz5x9h11Jxx8bDMAM",
"appsStatus": [],
"eventTitle": "quick chat",
"eventDescription": "",
"price": 0,
"currency": "usd",
"length": 30,
"bookingId": 3900,
"rescheduleId": 3899,
"rescheduleUid": "r543Dk3BeyfTafREgkSU8v",
"rescheduleStartTime": "2025-07-16T23:30:00Z",
"rescheduleEndTime": "2025-07-17T00:00:00Z",
"metadata": {},
"status": "ACCEPTED"
}
}
```
```json BOOKING_PAYMENT_INITIATED theme={null}
{
"triggerEvent": "BOOKING_PAYMENT_INITIATED",
"createdAt": "2025-11-07T04:55:49.061Z",
"payload": {
"bookerUrl": "https://lunacal.co",
"type": "webhooks",
"title": "Webhooks between Anupam Singh and webhook paid event",
"eventTypeTitle": "Webhooks",
"customCalendarInviteHeading": null,
"description": "",
"additionalNotes": "",
"customInputs": {},
"startTime": "2025-11-07T07:30:00Z",
"endTime": "2025-11-07T07:45:00Z",
"organizer": {
"id": 3539,
"name": "Anupam Singh",
"email": "theanupamsingh01@gmail.com",
"username": "the-anupam-singh",
"timeZone": "Asia/Calcutta",
"language": {
"locale": "en"
},
"timeFormat": "h:mma",
"utcOffset": 330
},
"responses": {
"name": {
"label": "your_name",
"value": "webhook paid event",
"isHidden": false
},
"email": {
"label": "email_address",
"value": "jake.tessy.blosi@gmail.com",
"isHidden": false
},
"location": {
"label": "location",
"value": {
"optionValue": "",
"value": "integrations:google:meet"
},
"isHidden": false
},
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"userFieldsResponses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"attendees": [
{
"email": "jake.tessy.blosi@gmail.com",
"name": "webhook paid event",
"firstName": "",
"lastName": "",
"timeZone": "Asia/Calcutta",
"language": {
"locale": "en"
},
"utcOffset": 330
}
],
"location": "integrations:google:meet",
"destinationCalendar": [
{
"id": 5082,
"integration": "google_calendar",
"externalId": "theanupamsingh01@gmail.com",
"userId": 3539,
"eventTypeId": null,
"credentialId": 12673,
"primaryEmail": "theanupamsingh01@gmail.com"
}
],
"hideCalendarNotes": false,
"requiresConfirmation": true,
"eventTypeId": 9695,
"seatsShowAttendees": true,
"seatsPerTimeSlot": null,
"seatsShowAvailabilityCount": true,
"schedulingType": null,
"iCalUID": "wKzN5eZ4gwmskm1gr8S5rh@Lunacal",
"iCalSequence": 0,
"disableCancelling": false,
"disableRescheduling": false,
"uid": "wKzN5eZ4gwmskm1gr8S5rh",
"eventTitle": "Webhooks",
"eventDescription": "",
"price": 400,
"currency": "inr",
"length": 15,
"bookingId": 40489,
"metadata": {},
"status": "ACCEPTED",
"paymentId": 625,
"couponData": {
"couponCode": "FIFTY50",
"discountType": "PERCENTAGE_OFF",
"discountValue": 50,
"discountedPrice": 2.5,
"guestEmail": "rober.sullivan.rmv@gmail.com",
"usedAt": "2025-11-21T08:09:28.929Z"
},
"rescheduleUrl": "https://lunacal.co/reschedule/wKzN5eZ4gwmskm1gr8S5rh",
"cancelUrl": "https://lunacal.co/booking/wKzN5eZ4gwmskm1gr8S5rh?cancel=true&allRemainingBookings=false"
}
}
```
```json BOOKING_PAID theme={null}
{
"triggerEvent": "BOOKING_PAID",
"createdAt": "2025-11-07T04:57:23.891Z",
"payload": {
"type": "webhooks",
"title": "Webhooks between Anupam Singh and webhook paid event",
"eventTypeTitle": "Webhooks",
"bookerUrl": "https://lunacal.ai",
"startTime": "2025-11-07T07:30:00.000Z",
"endTime": "2025-11-07T07:45:00.000Z",
"customInputs": {},
"userFieldsResponses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"responses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"organizer": {
"email": "theanupamsingh01@gmail.com",
"name": "Anupam Singh",
"timeZone": "Asia/Calcutta",
"timeFormat": "h:mma",
"language": {
"locale": "en"
},
"id": 3539,
"utcOffset": 330
},
"attendees": [
{
"name": "webhook paid event",
"email": "jake.tessy.blosi@gmail.com",
"timeZone": "Asia/Calcutta",
"status": true,
"referenceUid": null,
"language": {
"locale": "en"
},
"utcOffset": 330
}
],
"location": "integrations:google:meet",
"uid": "wKzN5eZ4gwmskm1gr8S5rh",
"destinationCalendar": [
{
"id": 5082,
"integration": "google_calendar",
"externalId": "theanupamsingh01@gmail.com",
"userId": 3539,
"eventTypeId": null,
"credentialId": 12673,
"primaryEmail": "theanupamsingh01@gmail.com"
}
],
"recurringEvent": null,
"seatsShowAttendees": false,
"seatsPerTimeSlot": null,
"conferenceData": {
"createRequest": {
"requestId": "8a0ce172-f69a-51b5-8481-93feb73d58e2"
}
},
"iCalUID": "uv3d365gcsrn89r7m0q833nlp0@google.com",
"eventTitle": "Webhooks",
"eventDescription": "",
"requiresConfirmation": null,
"price": 400,
"currency": "inr",
"length": 15,
"bookingId": 40489,
"eventTypeId": 9695,
"status": "ACCEPTED",
"paymentId": 625,
"metadata": {
"identifier": "lunacal.ai",
"bookingId": 40489,
"eventTypeId": 9695,
"bookerEmail": "jake.tessy.blosi@gmail.com",
"eventTitle": "Webhooks",
"externalId": "pi_3SQhiCSpZXWWqjds0BSudOwq"
},
"couponData": {
"couponCode": "FIFTY50",
"discountType": "PERCENTAGE_OFF",
"discountValue": 50,
"discountedPrice": 2.5,
"guestEmail": "rober.sullivan.rmv@gmail.com",
"usedAt": "2025-11-21T08:09:28.929Z"
},
"rescheduleUrl": "https://lunacal.ai/reschedule/wKzN5eZ4gwmskm1gr8S5rh",
"cancelUrl": "https://lunacal.ai/booking/wKzN5eZ4gwmskm1gr8S5rh?cancel=true&allRemainingBookings=false"
}
}
```
```json BOOKING_REQUESTED theme={null}
{
"triggerEvent": "BOOKING_REQUESTED",
"createdAt": "2025-11-07T05:05:18.108Z",
"payload": {
"bookerUrl": "https://lunacal.co",
"type": "manual-approval",
"title": "manual approval between Anupam Singh and jake",
"eventTypeTitle": "manual approval",
"customCalendarInviteHeading": null,
"description": "",
"additionalNotes": "",
"customInputs": {},
"startTime": "2025-11-07T07:15:00Z",
"endTime": "2025-11-07T07:30:00Z",
"organizer": {
"id": 3539,
"name": "Anupam Singh",
"email": "theanupamsingh01@gmail.com",
"username": "the-anupam-singh",
"timeZone": "Asia/Calcutta",
"language": {
"locale": "en"
},
"timeFormat": "h:mma",
"utcOffset": 330
},
"responses": {
"name": {
"label": "your_name",
"value": "jake",
"isHidden": false
},
"email": {
"label": "email_address",
"value": "jake.tessy.blosi@gmail.com",
"isHidden": false
},
"location": {
"label": "location",
"value": {
"optionValue": "",
"value": "integrations:google:meet"
},
"isHidden": false
},
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"userFieldsResponses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"attendees": [
{
"email": "jake.tessy.blosi@gmail.com",
"name": "jake",
"firstName": "",
"lastName": "",
"timeZone": "Asia/Calcutta",
"language": {
"locale": "en"
},
"utcOffset": 330
}
],
"location": "integrations:google:meet",
"conferenceCredentialId": 12674,
"destinationCalendar": [
{
"id": 5082,
"integration": "google_calendar",
"externalId": "theanupamsingh01@gmail.com",
"userId": 3539,
"eventTypeId": null,
"credentialId": 12673,
"primaryEmail": "theanupamsingh01@gmail.com"
}
],
"hideCalendarNotes": false,
"requiresConfirmation": true,
"eventTypeId": 9393,
"seatsShowAttendees": true,
"seatsPerTimeSlot": null,
"seatsShowAvailabilityCount": true,
"schedulingType": null,
"iCalUID": "qQzq1sFewdm6bpMTVk9QCE@Lunacal",
"iCalSequence": 0,
"disableCancelling": false,
"disableRescheduling": false,
"uid": "qQzq1sFewdm6bpMTVk9QCE",
"eventTitle": "manual approval",
"eventDescription": "",
"price": 0,
"currency": "usd",
"length": 15,
"bookingId": 40490,
"metadata": {},
"status": "PENDING",
"rescheduleUrl": "https://lunacal.co/reschedule/qQzq1sFewdm6bpMTVk9QCE",
"cancelUrl": "https://lunacal.co/booking/qQzq1sFewdm6bpMTVk9QCE?cancel=true&allRemainingBookings=false"
}
}
```
```json BOOKING_REJECTED theme={null}
{
"triggerEvent": "BOOKING_REJECTED",
"createdAt": "2025-11-07T05:05:30.526Z",
"payload": {
"type": "manual-approval",
"title": "manual approval between Anupam Singh and jake",
"eventTypeTitle": "manual approval",
"bookerUrl": "https://lunacal.ai",
"userFieldsResponses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"responses": {
"title": {
"label": "what_is_this_meeting_about",
"isHidden": true
},
"attendee-phone": {
"label": "Your Phone Number",
"isHidden": true
},
"guests": {
"label": "additional_guests",
"value": [],
"isHidden": false
},
"notes": {
"label": "form_comments",
"isHidden": false
},
"rescheduleReason": {
"label": "reason_for_reschedule",
"isHidden": true
}
},
"customInputs": {},
"startTime": "2025-11-07T07:15:00.000Z",
"endTime": "2025-11-07T07:30:00.000Z",
"organizer": {
"email": "theanupamsingh01@gmail.com",
"name": "Anupam Singh",
"username": "the-anupam-singh",
"timeZone": "Asia/Calcutta",
"timeFormat": "h:mma",
"language": {
"locale": "en"
},
"utcOffset": 330
},
"attendees": [
{
"name": "jake",
"email": "jake.tessy.blosi@gmail.com",
"timeZone": "Asia/Calcutta",
"language": {
"locale": "en"
},
"utcOffset": 330
}
],
"location": "integrations:google:meet",
"uid": "qQzq1sFewdm6bpMTVk9QCE",
"destinationCalendar": [
{
"id": 5082,
"integration": "google_calendar",
"externalId": "theanupamsingh01@gmail.com",
"userId": 3539,
"eventTypeId": null,
"credentialId": 12673,
"primaryEmail": "theanupamsingh01@gmail.com"
}
],
"requiresConfirmation": true,
"eventTypeId": 9393,
"rejectionReason": "",
"eventTitle": "manual approval",
"eventDescription": "",
"price": 0,
"currency": "usd",
"length": 15,
"bookingId": 40490,
"status": "REJECTED",
"rescheduleUrl": "https://lunacal.ai/reschedule/qQzq1sFewdm6bpMTVk9QCE",
"cancelUrl": "https://lunacal.ai/booking/qQzq1sFewdm6bpMTVk9QCE?cancel=true&allRemainingBookings=false"
}
}
```
> you can use [https://webhook.site/](https://webhook.site/) to test these webhooks without having to write any code.
## Example
Here is a simple example of a server that receives HTTP webhook requests.
```go golang theme={null}
package main
import (
"fmt"
"io"
"net/http"
)
func webhookHandler(w http.ResponseWriter, r *http.Request) {
switch r.Method {
case http.MethodGet:
fmt.Println("Received GET request")
for k, v := range r.URL.Query() {
fmt.Printf("%s = %s\n", k, v)
}
case http.MethodPost:
body, _ := io.ReadAll(r.Body)
defer r.Body.Close()
fmt.Println("Received POST request")
fmt.Println("Body:", string(body))
default:
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
w.WriteHeader(http.StatusOK)
}
func main() {
http.HandleFunc("/", webhookHandler)
fmt.Println("Listening on :8080")
http.ListenAndServe(":8080", nil)
}
```
```javascript javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());
app.get('/', (req, res) => {
console.log('Received GET request');
console.log(req.query);
res.status(200).send({ ok: true, status: 200, message: 'Webhook received' });
});
app.post('/', (req, res) => {
console.log('Received POST request');
console.log(req.body);
res.status(200).send({ ok: true, status: 200, message: 'Webhook received' });
});
app.listen(8080, () => {
console.log('Listening on http://localhost:8080');
});
```
> please use a service like [ngrok](https://ngrok.com/) if you are testing locally.