Skip to main content
POST
/
v4
/
booking
Create appointment booking
curl --request POST \
  --url https://api.example.com/v4/booking \
  --header 'Content-Type: application/json' \
  --data '
{
  "attendee": {
    "receiveReminders": true,
    "notes": {},
    "email": "jsmith@example.com",
    "firstname": "<string>",
    "lastname": "<string>",
    "fullname": "<string>",
    "bringalongEmails": [
      "jsmith@example.com"
    ],
    "phone": "<string>",
    "language": "en",
    "timezone": "<string>",
    "dataPolicyAccepted": true
  },
  "meetingTypeId": "<string>",
  "start": "<string>",
  "hostIds": [
    "<string>"
  ],
  "appointmentId": "<string>",
  "location": "<string>",
  "queueId": "<string>",
  "channel": "local",
  "duration": 123,
  "routingFormId": "<string>",
  "ignoreAvailability": true,
  "attendeePendingId": 123,
  "paymentId": "<string>",
  "paymentProvider": "paypal",
  "couponCode": "<string>",
  "resourceChannelIds": [
    "<string>"
  ],
  "oneTimeLinkId": "<string>",
  "skipNotifications": true,
  "phoneOnlyBooking": true,
  "icsTitle": "<string>",
  "icsDescription": "<string>",
  "rwgToken": "<string>",
  "rwgMerchantId": "<string>",
  "bookingPassword": "<string>",
  "waitlistToken": "<string>"
}
'
{
  "appointmentId": "<string>",
  "secret": "<string>",
  "attendeeEmail": "<string>",
  "bookingType": "doubleOptIn",
  "provisionalBookingId": "<string>",
  "redirectUrl": "<string>",
  "recurringSeriesId": "<string>",
  "recurringOccurrences": 123,
  "appointmentIds": [
    "<string>"
  ],
  "bundleId": "<string>",
  "isBundleBooking": true
}

Documentation Index

Fetch the complete documentation index at: https://developer.meetergo.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
attendee
object
required
​
meetingTypeId
string
required

ID of the meeting type to book.

​
start
string
required
​
hostIds
string[]

Host IDs for the booking. Required for one-on-one bookings (specific host selection). Optional for round-robin/queue bookings where queueId is provided instead.

​
appointmentId
string
​
location
string
​
queueId
string

required when meeting type has a queue (round-robin / co-host) must be undefined for non-queue meetings (one-to-one / group) if host selection is true, queue id is required if fastest host selection is chosen if hosts selection is true, queue id must be undefined if a specific host is chosen

​
channel
enum<string>

Meeting channel/location type

Available options:
local,
local-attendee,
google,
zoom,
phone,
phone-incoming,
whatsapp,
connect,
webex,
skypeForConsumer,
skypeForBusiness,
teamsForBusiness,
teamsForBusiness2,
teamsForExchange,
teams2ForExchange,
custom,
resource,
whereby,
kmeet,
zava,
jitsi
​
duration
number

Duration in minutes for the booking. Optional. If not provided, uses the meeting type's default duration. If provided, must match either the default duration or one of the allowed durations configured for the meeting type. Primarily needed when meeting type has multiple duration options (allowedDurations).

​
routingFormId
string
​
ignoreAvailability
boolean

Used mainly for instant booker to skip availability checks and payment validation for hosts

​
attendeePendingId
number

ID of pending attendee that will be deleted after successful booking. This is only needed when "collect during form entry" feature is used. If not provided, a successful booking may show up in pending contacts.

​
paymentId
string
​
paymentProvider
enum<string>

Selected payment provider for this booking. Required when the meeting type has multiple payment providers enabled. If not provided, falls back to the first enabled provider.

Available options:
paypal,
stripe,
none
​
couponCode
string

Coupon code for a discount on paid bookings. Validated during payment order creation and re-validated at booking time.

Maximum string length: 32
​
resourceChannelIds
string[]

Ids of the resource channel entity

​
oneTimeLinkId
string

Id of the one time booking link. Required in order to invalidate the booking link, once booking is done

​
skipNotifications
boolean

Skip sending email notifications to the attendee for this booking

​
phoneOnlyBooking
boolean

When true, attendee email is not required and phone becomes the identifier. Requires the meeting type to have allowPhoneOnlyBooking enabled in its options. Designed for voice agent / phone scheduling use cases where collecting email from the caller is not viable.

​
icsTitle
string

Custom ICS calendar invite title. If provided, overrides the configured meeting type ICS title for this specific booking. Useful for AI-generated titles based on conversation context (e.g., from calgent).

Maximum string length: 200
​
icsDescription
string

Custom ICS calendar invite description. If provided, overrides the configured meeting type ICS description for this specific booking. Useful for AI-generated descriptions based on conversation context (e.g., from calgent).

Maximum string length: 2000
​
rwgToken
string

Google Actions Center token for conversion tracking. This token is passed via the rwg_token URL parameter when users click through from Google Maps/Search.

Maximum string length: 500
​
rwgMerchantId
string

Merchant ID associated with the rwg_token for Google Actions Center. Used to determine if merchant changed during booking flow.

​
bookingPassword
string

Password for accessing a password-protected booking page. Required when the meeting type has password protection enabled.

​
waitlistToken
string

Waitlist unsubscribe token. When provided (from the ?wl= URL param on the booking link), the corresponding waitlist entry is removed after successful booking and the attendee is tagged as originating from the waitlist.

Response

​
appointmentId
string

ID of appointment. Undefined if DOI flow and not confirmed yet.

​
secret
string
​
attendeeEmail
string
​
bookingType
enum<string>

Only defined if DOI flow is enabled. If undefined, its a normal booking

Available options:
doubleOptIn,
requireHostConfirmation
​
provisionalBookingId
string

ID of provsionalBooking. Undefined if its a normal booking.

​
redirectUrl
string

Redirect URL to navigate to after booking (with any variables replaced). Only set if meeting type has redirect enabled and a URL is configured. This is the single source of truth for redirects.

​
recurringSeriesId
string

ID of the recurring series if this is a recurring booking. Undefined for non-recurring bookings.

​
recurringOccurrences
number

Total number of occurrences booked if this is a recurring booking. Undefined for non-recurring bookings.

​
appointmentIds
string[]

IDs of all appointments created in this recurring booking. Undefined for non-recurring bookings.

​
bundleId
string

ID of the bundle if this is a bundle booking. Undefined for non-bundle bookings.

​
isBundleBooking
boolean

Whether this is a bundle booking.