Create booking

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-10T09:00:00.000Z",
    "end": "2026-10-10T09:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": {
      "name": "Alice Smith",
      "email": "alice@example.com",
      "location": { "value": "integrations:zoom", "optionValue": "" }
    },
    "language": "en"
  }'

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-11T10:00:00.000Z",
    "end": "2026-10-11T10:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": { "name": "Alice Smith", "email": "alice@example.com" },
    "rescheduleUid": "8f2b1c3e-4d5a-4b6c-9e7f-0a1b2c3d4e5f",
    "rescheduleReason": "Schedule conflict"
  }'

{
  "uid": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "title": "30 min call with Alice",
  "startTime": "2026-10-10T09:00:00.000Z",
  "endTime": "2026-10-10T09:30:00.000Z",
  "status": "ACCEPTED",
  "location": "integrations:zoom",
  "attendees": [
    { "name": "Alice Smith", "email": "alice@example.com", "timeZone": "America/New_York" }
  ],
  "references": [],
  "eventType": { "id": 42, "title": "30 min call", "slug": "30min" }
}

POST

api

mcp

bookings

create

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-10T09:00:00.000Z",
    "end": "2026-10-10T09:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": {
      "name": "Alice Smith",
      "email": "alice@example.com",
      "location": { "value": "integrations:zoom", "optionValue": "" }
    },
    "language": "en"
  }'

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-11T10:00:00.000Z",
    "end": "2026-10-11T10:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": { "name": "Alice Smith", "email": "alice@example.com" },
    "rescheduleUid": "8f2b1c3e-4d5a-4b6c-9e7f-0a1b2c3d4e5f",
    "rescheduleReason": "Schedule conflict"
  }'

{
  "uid": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "title": "30 min call with Alice",
  "startTime": "2026-10-10T09:00:00.000Z",
  "endTime": "2026-10-10T09:30:00.000Z",
  "status": "ACCEPTED",
  "location": "integrations:zoom",
  "attendees": [
    { "name": "Alice Smith", "email": "alice@example.com", "timeZone": "America/New_York" }
  ],
  "references": [],
  "eventType": { "id": 42, "title": "30 min call", "slug": "30min" }
}

Creates a booking for an event type. Bookings go through the same flow as the public Lunacal booking page, so every event type variant — including packages and subscriptions — is handled correctly.

Call Get availability first and pick a returned slot for start and end.

Body

integer

required

ID of the event type to book.

string

required

Slot start time in ISO 8601.

string

required

Slot end time in ISO 8601.

string

required

Attendee’s IANA time zone, e.g. America/New_York.

object

required

Answers to the event type’s booking form. Field names depend on the event type’s booking fields.

Show common fields

string

required

Attendee’s name.

string

required

Attendee’s email.

object

Selected location, e.g. { "value": "integrations:zoom", "optionValue": "" }.

string

Language for notifications, e.g. en.

object

Custom key-value data stored with the booking.

boolean

default:"false"

Whether the booking is made through a private (hashed) link.

string | null

The private link hash, if hasHashedBookingLink is true.

string

UID of an existing booking to reschedule. When set, that booking is moved to the new slot instead of a new booking being created.

string

Reason for rescheduling. Use with rescheduleUid.

Response

Returns the created or rescheduled booking. It has the same shape as items in List bookings, plus full attendee, reference, and conferencing details.

Rescheduling

To move an existing booking, send rescheduleUid and rescheduleReason with the new start and end. The original booking is cancelled and a new one is created at the new time.

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-10T09:00:00.000Z",
    "end": "2026-10-10T09:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": {
      "name": "Alice Smith",
      "email": "alice@example.com",
      "location": { "value": "integrations:zoom", "optionValue": "" }
    },
    "language": "en"
  }'

curl -X POST https://app.lunacal.ai/api/mcp/bookings/create \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "eventTypeId": 42,
    "start": "2026-10-11T10:00:00.000Z",
    "end": "2026-10-11T10:30:00.000Z",
    "timeZone": "America/New_York",
    "responses": { "name": "Alice Smith", "email": "alice@example.com" },
    "rescheduleUid": "8f2b1c3e-4d5a-4b6c-9e7f-0a1b2c3d4e5f",
    "rescheduleReason": "Schedule conflict"
  }'

{
  "uid": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "title": "30 min call with Alice",
  "startTime": "2026-10-10T09:00:00.000Z",
  "endTime": "2026-10-10T09:30:00.000Z",
  "status": "ACCEPTED",
  "location": "integrations:zoom",
  "attendees": [
    { "name": "Alice Smith", "email": "alice@example.com", "timeZone": "America/New_York" }
  ],
  "references": [],
  "eventType": { "id": 42, "title": "30 min call", "slug": "30min" }
}

Event Types

Availability

Advanced

Teams & Workspaces

Bookings

Integrations

Workflows

Dynamic Bookings

Bookings Page

Embed

Others

Webhooks

Zapier

UTM Setup

Report Vulnerability

MCP API

Body

Response

Rescheduling

​Body

​Response

​Rescheduling

Body

Response

Rescheduling