Skip to main content
PATCH
Update meeting type

Authorizations

x-meetergo-api-user-id
string
header
required

User ID to act on behalf of. Platform API Keys only (required with an API Key unless the endpoint states otherwise). Requests authenticated with a Personal Access Token are rejected if this header names another user.

Path Parameters

id
string
required

Unique identifier of the meeting type to update

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
meetingInfo
object

Meeting information to update

meetingOptions
object

Meeting options to update

enabled
boolean

Enable or disable the meeting type

Example:

true

slug
string

Slug for the meeting type URL

Example:

"discovery-call"

timeslotInterval
number

Timeslot interval in minutes

Required range: 5 <= x <= 60
Example:

15

spots
number

Number of spots available per timeslot

Required range: 1 <= x <= 100
Example:

1

bookingMinimum
number

Minimum booking notice in minutes

Required range: 0 <= x <= 10080
Example:

60

daysIntoFuture
object

Date range settings for future bookings

locations
string[]

Available locations for in-person meetings

Example:
availabilityId
string<uuid>

ID of an existing availability to associate with this meeting type.

ics
object

Calendar invite (ICS) settings. Customize the title, description, and location of calendar events. Each field accepts a plain string (stored under the default language) or an object with language keys.

internalNotes
string | null

Internal note for organizers. Never shown to customers.

Maximum string length: 5000
Example:

"pi009_Markt Tansas Offenbach_TSO – Partner: Max Müller"

contactTags
string[]

Tags added to the CRM contact of everyone who books this meeting type. Existing contact tags are kept. At most 10 tags of up to 64 characters. Tags are trimmed, commas become spaces, and case-insensitive duplicates are dropped. Replaces the current tags. Pass an empty array to stop tagging.

Maximum array length: 10
Maximum string length: 64
Example:
sendHostCalendarInvite
boolean

Host notification emails carry a calendar invite. On by default. Off keeps the host calendar to the synced booking only. Must be a JSON boolean.

Example:

true

communicationSettings
object

Notification switches, as in the Notifications tab of the dashboard. Only the fields you send change. Like the dashboard, a meeting type whose template locks its notifications keeps the template values.

Response

Meeting type updated successfully

id
string
required
meetingInfo
object
required
meetingOptions
object
required
crmOptions
object
required
contactTags
string[]
required

Tags added to the CRM contact of everyone who books.

ics
object
required
timeslotInterval
number
required
spots
number
required
enabled
boolean
required
slug
string
required
bookingMinimum
number
required
connectMeetingTimer
enum<string>
required
Available options:
off,
host,
everyone
daysIntoFuture
object
required
enableCalendarInviteNotification
boolean
required
roundRobin
string[]
required
useSchedule
boolean
required
useCustomInvite
boolean
required
disableActionButtons
boolean
required
useCustomForm
boolean
required
inCompanyPage
boolean
required
formFirst
boolean
required
locations
string[]
required
isGlobalQueue
boolean
required
compact
boolean
required
disableTeamsEmail
boolean
required
calendarGuestListVisible
boolean
required
sendHostCalendarInvite
boolean
required
languageSetting
object
required
customTextSelectChannel
object
required
timezonePreset
object
required
timeFormat
enum<string>
required
Available options:
12,
24
showSlotEndTime
boolean
required

Show the end time on booking page time slots

bookingPageLayout
enum<string>
required

Booking page shows a month calendar or a list of dates

Available options:
calendar,
list
cssSetting
object
required
metaSetting
object
required
companyId
string
required
createdById
string
required
connectGuestJoinMinutesBeforeStart
number | null
Required range: 0 <= x <= 525600
connectGuestJoinMinutesAfterEnd
number | null
Required range: 0 <= x <= 525600
invoiceProductId
string | null

Invoicing product bookings of this meeting type are billed with

invoiceProductsByDuration
object | null

Invoicing product per bookable duration in minutes; a missing duration uses invoiceProductId

invoiceProductsByPriceOption
object | null

Invoicing product per price option id; wins over invoiceProductsByDuration

createdAt
string
updatedAt
string
deletedAt
string
workspaceId
string
userId
string
formId
string
availabilityId
string
queueId
string
reminderIds
string[]
workspace
object
user
object
createdBy
object
availability
object
form
object
reminders
object[]
metadata
object | null

Key-value metadata for integrations

Example:
internalNotes
string | null

Internal note for organizers. Never shown to customers.

communicationSettings
object | null

Notification switches. Null when the meeting type has no notification settings yet.

One-time booking link (only present when requested via options.createOneTimeLink)