Skip to main content
POST
/
v4
/
meeting-type
Create meeting type
curl --request POST \
  --url https://api.example.com/v4/meeting-type \
  --header 'Content-Type: application/json' \
  --header 'x-meetergo-api-user-id: <api-key>' \
  --data '
{
  "meetingInfo": {
    "name": "<string>",
    "description": "<string>",
    "enableRedirect": true,
    "redirect": "<string>",
    "duration": 123,
    "channel": "local",
    "customChannelName": "<string>",
    "customChannelLink": "<string>",
    "groupBooking": true,
    "enrichInvitee": true,
    "confirmationButton": {
      "useConfirmationButton": true,
      "text": "<string>",
      "color": "<string>",
      "link": "<string>"
    },
    "bufferBefore": 123,
    "bufferAfter": 123,
    "color": {}
  },
  "meetingOptions": {
    "allowedDurations": [
      15,
      30,
      60
    ],
    "allowSelectChannel": true,
    "allowHostSelection": true,
    "forceHostSelection": true,
    "allowedChannels": [
      "local"
    ],
    "allowAddingGuests": true,
    "doubleOptIn": "<string>",
    "requireHostConfirmation": "<string>",
    "enableClusterMeeting": true,
    "enableBufferCarryOver": true,
    "maxBufferCarryOverDelay": 123,
    "confirmationPageCssSetting": {
      "mode": 123
    },
    "channelAvailabilities": {
      "zoom": "uuid-of-availability",
      "phone": "uuid-of-other-availability"
    }
  },
  "slug": "<string>",
  "spots": 50.5,
  "isGlobalQueue": true,
  "workspaceId": "<string>",
  "userId": "<string>",
  "locations": [
    "Office A",
    "Conference Room B",
    "Remote"
  ],
  "resourceChannels": [
    {
      "resourceId": "<string>",
      "name": "<string>",
      "availabilityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "groupName": "<string>",
      "groupMemberIndex": 1
    }
  ],
  "cancellationPolicy": {
    "enable": true,
    "mode": "disabled",
    "duration": 123
  },
  "reschedulingPolicy": {
    "enable": true,
    "mode": "disabled",
    "duration": 123
  },
  "daysIntoFuture": {
    "mode": "limit",
    "bookingLimit": 43200,
    "rangeMin": "2025-01-01T00:00:00.000Z",
    "rangeMax": "2025-12-31T23:59:59.000Z"
  },
  "availabilityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "availability": {
    "name": "<string>",
    "timezone": "<string>",
    "schedule": {
      "monday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "tuesday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "wednesday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "thursday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "friday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "saturday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      },
      "sunday": {
        "enabled": true,
        "hours": [
          {
            "start": "<string>",
            "end": "<string>"
          }
        ]
      }
    },
    "exceptions": [
      {
        "available": true,
        "start": "<string>",
        "end": "<string>",
        "availabilityId": "<string>",
        "title": "<string>",
        "note": "<string>"
      }
    ]
  },
  "metadata": {
    "ticketId": "EVAL-12345"
  },
  "options": {
    "createOneTimeLink": true
  }
}
'
{
  "id": "<string>",
  "meetingInfo": {
    "name": "<string>",
    "description": "<string>",
    "enableRedirect": true,
    "redirect": "<string>",
    "duration": 123,
    "channel": "local",
    "customChannelName": "<string>",
    "customChannelLink": "<string>",
    "groupBooking": true,
    "enrichInvitee": true,
    "confirmationButton": {
      "useConfirmationButton": true,
      "text": "<string>",
      "color": "<string>",
      "link": "<string>"
    },
    "bufferBefore": 123,
    "bufferAfter": 123,
    "color": {}
  },
  "meetingOptions": {
    "allowedDurations": [
      15,
      30,
      60
    ],
    "allowSelectChannel": true,
    "allowHostSelection": true,
    "forceHostSelection": true,
    "allowedChannels": [
      "local"
    ],
    "allowAddingGuests": true,
    "doubleOptIn": "<string>",
    "requireHostConfirmation": "<string>",
    "enableClusterMeeting": true,
    "enableBufferCarryOver": true,
    "maxBufferCarryOverDelay": 123,
    "confirmationPageCssSetting": {
      "mode": 123
    },
    "channelAvailabilities": {
      "zoom": "uuid-of-availability",
      "phone": "uuid-of-other-availability"
    }
  },
  "crmOptions": {
    "hubspotContactSync": true,
    "hubspotContactStage": "<string>",
    "hubspotCompanySync": true,
    "hubspotCompanyStage": "<string>",
    "hubspotCompanyMatchingField": "<string>",
    "hubspotDealSync": true,
    "hubspotDealStage": "<string>",
    "hubspotPipelineId": "<string>",
    "pipedriveDealSync": true,
    "pipedriveContactSync": true,
    "pipedrivePipelineId": 123,
    "pipedriveStageId": 123,
    "linkandoSyncEnabled": true,
    "linkandoPlaybookId": 123,
    "linkandoTemplateId": 123,
    "evalancheEnabled": true,
    "klicktippEnabled": true,
    "getResponseEnabled": true,
    "getResponseCampaignId": "<string>",
    "brevoEnabled": true,
    "smartWeContactSync": true,
    "smartWeCompanySync": true,
    "smartWeDealSync": true,
    "smartWeDealStage": "<string>",
    "salesforceSyncEnabled": true,
    "salesforceCaseSync": true,
    "salesforceLeadSync": true,
    "salesforceOpportunitySync": true,
    "salesforceLeadStatus": "<string>",
    "salesforceCaseStatus": "<string>",
    "salesforceOpportunityStage": "<string>",
    "salesforceDefaultObjectType": "<string>"
  },
  "ics": {
    "title": {
      "en": "<string>",
      "de": "<string>",
      "fr": "<string>",
      "es": "<string>",
      "no": "<string>",
      "it": "<string>",
      "nl": "<string>"
    },
    "description": {
      "en": "<string>",
      "de": "<string>",
      "fr": "<string>",
      "es": "<string>",
      "no": "<string>",
      "it": "<string>",
      "nl": "<string>"
    },
    "location": {
      "en": "<string>",
      "de": "<string>",
      "fr": "<string>",
      "es": "<string>",
      "no": "<string>",
      "it": "<string>",
      "nl": "<string>"
    }
  },
  "timeslotInterval": 123,
  "spots": 123,
  "enabled": true,
  "slug": "<string>",
  "bookingMinimum": 123,
  "daysIntoFuture": {
    "mode": "<string>",
    "bookingLimit": 123,
    "rangeMin": "2023-11-07T05:31:56Z",
    "rangeMax": "2023-11-07T05:31:56Z"
  },
  "enableCalendarInviteNotification": true,
  "roundRobin": [
    "<string>"
  ],
  "useSchedule": true,
  "useCompanyLogo": true,
  "useCustomInvite": true,
  "disableActionButtons": true,
  "useCustomForm": true,
  "inCompanyPage": true,
  "formFirst": true,
  "locations": [
    "<string>"
  ],
  "isGlobalQueue": true,
  "compact": true,
  "disableTeamsEmail": true,
  "languageSetting": {
    "enable": true,
    "default": "<string>",
    "allowed": [
      "<string>"
    ]
  },
  "customTextSelectChannel": {
    "enable": true,
    "body": "<string>"
  },
  "timezonePreset": {
    "enable": true,
    "timezonePreset": "<string>"
  },
  "cssSetting": {
    "mode": 123
  },
  "metaSetting": {
    "nextBetaEnabled": true,
    "title": "<string>",
    "body": "<string>",
    "image": "<string>"
  },
  "companyId": "<string>",
  "createdById": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "deletedAt": "<string>",
  "workspaceId": "<string>",
  "userId": "<string>",
  "formId": "<string>",
  "availabilityId": "<string>",
  "queueId": "<string>",
  "reminderIds": [
    "<string>"
  ],
  "workspace": {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>"
  },
  "user": {
    "id": "<string>",
    "givenName": "<string>",
    "familyName": "<string>",
    "slug": "<string>",
    "userType": "<string>",
    "picture": "<string>"
  },
  "createdBy": {
    "id": "<string>",
    "givenName": "<string>",
    "familyName": "<string>",
    "slug": "<string>",
    "userType": "<string>",
    "picture": "<string>"
  },
  "availability": {
    "id": "<string>",
    "name": "<string>"
  },
  "form": {
    "id": "<string>",
    "name": "<string>"
  },
  "reminders": [
    {
      "id": 123,
      "name": "<string>"
    }
  ],
  "metadata": {
    "ticketId": "EVAL-12345"
  },
  "oneTimeLink": {
    "id": "<string>",
    "url": "<string>",
    "meetingTypeId": "<string>",
    "createdAt": "<string>"
  }
}

Authorizations

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

User ID to act as when using API Key authentication (required with API Key)

Body

application/json
​
meetingInfo
object
required

Meeting information

​
meetingOptions
object

Meeting options

​
slug
string

URL slug for the meeting type

​
spots
number

Number of available spots

Required range: 1 <= x <= 100
​
isGlobalQueue
boolean

Create as global queue meeting type

​
workspaceId
string

Workspace ID for workspace-based meeting types

​
userId
string

User ID for user-specific meeting types

​
locations
string[]

Available locations

Example:
["Office A", "Conference Room B", "Remote"]
​
resourceChannels
object[]

Resource channels for the meeting type

​
cancellationPolicy
object

Cancellation policy settings

​
reschedulingPolicy
object

Rescheduling policy settings

​
daysIntoFuture
object

Future booking window settings

​
availabilityId
string<uuid>

ID of an existing availability to use. Mutually exclusive with "availability".

​
availability
object

Create a new availability inline. Mutually exclusive with "availabilityId".

​
metadata
object

Key-value metadata for integrations

Example:
{ "ticketId": "EVAL-12345" }
​
options
object

Request options for additional operations

Response

​
id
string
required
​
meetingInfo
object
required
​
meetingOptions
object
required
​
crmOptions
object
required
​
ics
object
required
​
timeslotInterval
number
required
​
spots
number
required
​
enabled
boolean
required
​
slug
string
required
​
bookingMinimum
number
required
​
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
​
languageSetting
object
required
​
customTextSelectChannel
object
required
​
timezonePreset
object
required
​
cssSetting
object
required
​
metaSetting
object
required
​
companyId
string
required
​
createdById
string
required
​
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

Key-value metadata for integrations

Example:
{ "ticketId": "EVAL-12345" }
​
oneTimeLink
object

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