> ## 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.

# Get personal page data



## OpenAPI

````yaml /openapi.json get /v4/booking-link/personal-page/v2/{userSlug}
openapi: 3.0.0
info:
  title: meetergo Platform API
  description: >-
    Scheduling, CRM and invoicing in one API: create users, manage availability
    and bookings, connect calendars, keep contacts and deals in sync, and take
    an offer through to a paid invoice.
  version: 3.274.0
  contact: {}
  termsOfService: https://www.meetergo.com/tos/
servers: []
security: []
tags:
  - name: User V4
    description: Create and manage users in your workspace
  - name: Meeting Type V4
    description: Configure meeting templates with durations, buffers, and conferencing
  - name: availability
    description: Manage weekly schedules and availability settings
  - name: Booking V4
    description: Create new bookings
  - name: Booking Availability V4
    description: Query available time slots for booking
  - name: Appointment V4
    description: Manage existing appointments
  - name: Attendee V4
    description: Manage attendee details and notes
  - name: Calendar Connections V4
    description: Connect and sync external calendars
  - name: Signatures V4
    description: >-
      Send PDFs for e-signature and download the signed, eIDAS-grade document
      (DocuSeal-compatible)
  - name: WhatsApp V4
    description: >-
      Send and receive WhatsApp messages by phone number and read conversation
      history
  - name: One Time Booking Link V4
    description: Create single-use booking links
  - name: availability-exception
    description: Override availability for specific dates
  - name: Booking Link V4
    description: Configure various booking page types
  - name: Personal Page V4
    description: Manage user profile pages
  - name: Handoff V4
    description: Reassign meetings to other hosts
  - name: Calendar Auth V4
    description: OAuth callbacks for calendar providers
  - name: CRM Contacts
    description: >-
      Create, find, and update the people in your CRM, including their custom
      data fields
  - name: CRM Deals
    description: >-
      Create, update, and track deals through pipeline stages (incl. per-deal
      activity history)
  - name: CRM Pipelines
    description: Manage pipelines and their stages
  - name: CRM Tasks
    description: Tasks on contacts, deals and companies
  - name: CRM Notes
    description: Notes on contacts, deals and companies
  - name: CRM Attachments
    description: Files attached to contacts, deals and companies
  - name: CRM Communications
    description: Logged calls, messages and meetings on contacts, deals and companies
  - name: CRM Email Sync
    description: Read the email history synced from connected mailboxes (read-only)
  - name: Data Fields
    description: >-
      Define the custom fields a contact can carry; their `name` is the key used
      in a contact's additionalData
  - name: Invoicing Documents
    description: >-
      Offers and invoices: create a draft, finalize it into a numbered
      e-invoice, send it, record payments, and run Mahnwesen
  - name: Invoicing Products
    description: Reusable products for invoice line items
  - name: Invoicing Settings
    description: Seller details, tax treatment, bank accounts, and number ranges
  - name: Invoicing Recurring
    description: >-
      Recurring schedules, billing runs over completed meetings, buyer prefill,
      and DATEV export
  - name: Queue V4
    description: Round-robin and queue-based routing (Beta)
  - name: Queue User Group V4
    description: Manage queue user groups (Beta)
  - name: Meeting Type Template V4
    description: Reusable meeting type configurations (Beta)
  - name: Attendee Pending V4
    description: Manage pending attendee approvals (Beta)
  - name: Provisional Booking V4
    description: Manage provisional/unconfirmed bookings (Beta)
paths:
  /v4/booking-link/personal-page/v2/{userSlug}:
    get:
      tags:
        - Booking Link V4
      summary: Get personal page data
      operationId: getPersonalPage
      parameters:
        - name: userSlug
          required: true
          in: path
          description: User slug
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonalBookingPageResponseDto'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PersonalBookingPageResponseDto'
components:
  schemas:
    PersonalBookingPageResponseDto:
      type: object
      properties:
        user:
          description: User information
          allOf:
            - $ref: '#/components/schemas/PersonalPageUserV4'
        company:
          description: Company information
          allOf:
            - $ref: '#/components/schemas/PublicCompanyInfo'
        meetingTypes:
          description: Array of meeting types with their booking links
          type: array
          items:
            $ref: '#/components/schemas/ExtendedMeetingTypeResponseDto'
      required:
        - user
        - company
        - meetingTypes
    PersonalPageUserV4:
      type: object
      properties:
        id:
          type: string
        firstname:
          type: string
        lastname:
          type: string
          nullable: true
        title:
          type: string
        picture:
          type: string
        personalPage:
          $ref: '#/components/schemas/PersonalPageWithoutMeetingTypes'
      required:
        - id
        - firstname
        - lastname
        - personalPage
    PublicCompanyInfo:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
          description: >-
            Company slug. Public pages address the company by it, e.g. the
            statutory withdrawal page at /widerruf/<slug>.
        description:
          type: string
        logo:
          type: string
        tier:
          allOf:
            - $ref: '#/components/schemas/CompanyTier'
        primaryColor:
          type: string
        useBrandStyling:
          type: boolean
        hideMeetergoBranding:
          type: boolean
        businessCardTheme:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/BusinessCardTheme'
        enforceBusinessCardTheme:
          type: boolean
        showDataPolicyLink:
          type: boolean
        hideDataPolicyCheckbox:
          type: boolean
        enableWithdrawalFunction:
          type: boolean
          description: >-
            Whether the statutory withdrawal function (§ 356a BGB) is published
            for this company. Drives the "Vertrag widerrufen" link in the
            booking pages' legal footer.
        dataPolicyLink:
          type: string
          nullable: true
        imprintLink:
          type: string
          nullable: true
        deleted:
          type: boolean
        useFormalBookingLanguage:
          type: boolean
        enableCustomLegalText:
          type: boolean
        enableCookieBanner:
          type: boolean
        customLegalText:
          type: string
        customBookingCSS:
          type: string
        featureAccess:
          $ref: '#/components/schemas/FeatureAccess'
        language:
          type: string
        allowedLanguages:
          type: array
          items:
            type: string
        googleAnalyticsMeasurementId:
          type: string
          nullable: true
        metaPixelId:
          type: string
          nullable: true
        tiktokPixelId:
          type: string
          nullable: true
        gtmContainerId:
          type: string
          nullable: true
        gtmServerContainerUrl:
          type: string
          nullable: true
        matomoUrl:
          type: string
          nullable: true
        matomoSiteId:
          type: string
          nullable: true
        usercentricsSettingsId:
          type: string
        usercentricsConfig:
          type: object
      required:
        - id
        - name
        - slug
        - description
        - tier
        - primaryColor
        - useBrandStyling
        - hideMeetergoBranding
        - enforceBusinessCardTheme
        - showDataPolicyLink
        - hideDataPolicyCheckbox
        - enableWithdrawalFunction
        - dataPolicyLink
        - imprintLink
        - deleted
        - useFormalBookingLanguage
        - enableCustomLegalText
        - enableCookieBanner
        - customLegalText
        - customBookingCSS
        - featureAccess
        - language
        - googleAnalyticsMeasurementId
        - metaPixelId
        - tiktokPixelId
        - gtmContainerId
        - gtmServerContainerUrl
        - matomoUrl
        - matomoSiteId
    ExtendedMeetingTypeResponseDto:
      type: object
      properties:
        meetingType:
          description: Meeting type information
          allOf:
            - $ref: '#/components/schemas/MeetingTypeResponseDto'
        link:
          type: string
          description: Booking link for this meeting type
      required:
        - meetingType
        - link
    ApiError:
      type: object
      required:
        - statusCode
        - message
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          description: >-
            A sentence, or the list of field constraints that failed. Validation
            errors name the offending property.
          example:
            - limit must not be greater than 100
        error:
          type: string
          example: BadRequestException
    PersonalPageWithoutMeetingTypes:
      type: object
      properties:
        useCustomColors:
          type: boolean
        primaryColor:
          type: string
        secondaryColor:
          type: string
        headerImage:
          type: string
          nullable: true
        theme:
          nullable: true
          description: >-
            Card theme (preset + overrides). Null means the default look; the
            legacy useCustomColors/primaryColor pair is honored only while theme
            is null.
          allOf:
            - $ref: '#/components/schemas/BusinessCardTheme'
        blocks:
          nullable: true
          description: >-
            Ordered content blocks (headline, text, video, file, divider) shown
            on the card. Sanitized in updatePersonaPage.
          type: array
          items:
            $ref: '#/components/schemas/CardBlock'
        businessCardDraft:
          type: object
          nullable: true
          description: >-
            Staged, not-yet-published design edits: { theme?, blocks? }. Null
            means no unpublished changes. Never served on public surfaces.
        description:
          type: string
        onlineProfiles:
          $ref: '#/components/schemas/OnlineProfiles'
        showAllMeetingTypes:
          type: boolean
          description: >-
            If true, show all user meeting types on business card. If false,
            show only selected meeting types.
          default: true
        showMeetingsSection:
          type: boolean
          description: >-
            If true, the card renders the automatic meetings section (heading,
            "show all" toggle, its own list) above the content blocks. Cards
            created since the block editor took over start without it: booking
            options are placed as `meetingType` blocks instead, so images and
            text can sit between them. Backfilled to true for every card that
            already showed at least one booking option.
          default: false
        showContactExchange:
          type: boolean
          description: >-
            If true, the card offers visitors the contact-exchange form beside
            "save contact". Owners who only want to hand out their own details
            switch it off.
          default: true
        meetingTypeOrder:
          type: array
          items:
            type: string
      required:
        - useCustomColors
        - primaryColor
        - secondaryColor
        - headerImage
        - description
        - onlineProfiles
        - showAllMeetingTypes
        - showMeetingsSection
        - showContactExchange
    CompanyTier:
      type: string
      enum:
        - basic
        - essentials
        - growth
        - teams
        - light
        - suite
        - premium
        - enterprise
    BusinessCardTheme:
      type: object
      properties:
        preset:
          type: string
          description: Theme preset key, e.g. classic, nocturne
        accent:
          type: string
          description: Hex accent color override
        background:
          $ref: '#/components/schemas/BusinessCardBackground'
        font:
          type: string
          enum:
            - sans
            - serif
            - grotesk
            - mono
            - condensed
            - rounded
        buttonShape:
          type: string
          enum:
            - sharp
            - rounded
            - pill
    FeatureAccess:
      type: object
      properties:
        polls:
          type: boolean
        advancedMeetingTypeSettings:
          type: boolean
        workflows:
          type: boolean
        maxWorkflows:
          type: number
          description: '-1 means unlimited'
        meetingTypeCommunications:
          type: boolean
        multiHostBooking:
          type: boolean
        groupBooking:
          type: boolean
        enrichInvitee:
          type: boolean
        autoCreateSpace:
          type: boolean
        zapier:
          type: boolean
        personalizedBranding:
          type: boolean
        visualBranding:
          type: boolean
        crmIntegration:
          type: boolean
        cmpIntegration:
          type: boolean
        routingForms:
          type: boolean
        basicForms:
          type: boolean
        selectionPages:
          type: boolean
        dataFields:
          type: boolean
        roundRobin:
          type: boolean
        accountOwnerMatching:
          type: boolean
        handoff:
          type: boolean
        reschedule:
          type: boolean
        notifications:
          type: boolean
        workspaces:
          type: boolean
        api:
          type: boolean
        showcaseHubs:
          type: boolean
        meetergoConnect:
          type: boolean
        connectMaxParticipants:
          type: number
        connectMaxCallMinutes:
          type: number
        connectRecording:
          type: boolean
        connectBreakouts:
          type: boolean
        connectWebinars:
          type: boolean
        webhooks:
          type: boolean
        wallets:
          type: boolean
        dealSpace:
          type: boolean
        funnel:
          type: boolean
        unlimitedMeetingTypes:
          type: boolean
        salesforceIntegration:
          type: boolean
        salesforceStudioMapping:
          type: boolean
        salesforceRouting:
          type: boolean
        maximumCalendars:
          type: number
        disableIntercom:
          type: boolean
        supportChat:
          type: boolean
        evalancheIntegration:
          type: boolean
        analytics:
          type: boolean
        bookingFunnel:
          type: boolean
        funnelProgressAndInfobox:
          type: boolean
        contactsBeta:
          type: boolean
        paypalIntegration:
          type: boolean
        stripeIntegration:
          type: boolean
        mollieIntegration:
          type: boolean
        meetingTypeTemplates:
          type: boolean
        nextBeta:
          type: boolean
        video:
          type: boolean
        emailLayout:
          type: boolean
        reviews:
          type: boolean
        brevoIntegration:
          type: boolean
        getResponseIntegration:
          type: boolean
        customDomain:
          type: boolean
        maxCustomDomains:
          type: number
        maxViewers:
          type: number
          description: '-1 means unlimited'
        apiPlatform:
          type: boolean
        slackIntegration:
          type: boolean
        calgent:
          type: boolean
        miraPipelineAutopilot:
          type: boolean
        fileUploads:
          type: boolean
        knowledgePageLimit:
          type: number
        storageQuotaMB:
          type: number
        recordingRetentionDays:
          type: number
        multiBooking:
          type: boolean
        bundles:
          type: boolean
        maxCrmDeals:
          type: number
        maxShowcaseHubs:
          type: number
        maxDealSpaces:
          type: number
        waitlist:
          type: boolean
        notetaker:
          type: boolean
        notetakerRecording:
          type: boolean
        maxNotetakerRecapsPerMonth:
          type: number
        maxLinkedInLookupsPerMonth:
          type: number
        quickMail:
          type: boolean
        enrichDealSpaceCompany:
          type: boolean
        whatsappAddon:
          type: boolean
        conversionWidgetNativeScheduling:
          type: boolean
        instagramDms:
          type: boolean
        bookingCoupons:
          type: boolean
        crmEmailSync:
          type: boolean
        websiteChat:
          type: boolean
        emailChannel:
          type: boolean
        teamChat:
          type: boolean
        aiPhoneAssistant:
          type: boolean
        aiPhoneAssistantAdvanced:
          type: boolean
        bookingLocations:
          type: boolean
        bookingBlocks:
          type: boolean
        invoicing:
          type: boolean
        purchaseDocuments:
          type: boolean
        hostedEvents:
          type: boolean
        hostedEventTicketing:
          type: boolean
        paymentLinks:
          type: boolean
        feedbackLoop:
          type: boolean
        newsletter:
          type: boolean
        maxFormSubmissionsPerMonth:
          type: number
        maxSignatureRequestsPerMonth:
          type: number
        advancedSignatures:
          type: boolean
        maxAdvancedSignatureRequestsPerMonth:
          type: number
        maxInvoicesPerMonth:
          type: number
        whatsappAiAgent:
          type: boolean
        customSmtp:
          type: boolean
        csvExport:
          type: boolean
      required:
        - polls
        - advancedMeetingTypeSettings
        - workflows
        - maxWorkflows
        - meetingTypeCommunications
        - multiHostBooking
        - groupBooking
        - enrichInvitee
        - autoCreateSpace
        - zapier
        - personalizedBranding
        - visualBranding
        - crmIntegration
        - cmpIntegration
        - routingForms
        - basicForms
        - selectionPages
        - dataFields
        - roundRobin
        - accountOwnerMatching
        - handoff
        - reschedule
        - notifications
        - workspaces
        - api
        - showcaseHubs
        - meetergoConnect
        - connectMaxParticipants
        - connectMaxCallMinutes
        - connectRecording
        - connectBreakouts
        - connectWebinars
        - webhooks
        - wallets
        - dealSpace
        - funnel
        - unlimitedMeetingTypes
        - salesforceIntegration
        - salesforceStudioMapping
        - salesforceRouting
        - maximumCalendars
        - disableIntercom
        - supportChat
        - evalancheIntegration
        - analytics
        - bookingFunnel
        - funnelProgressAndInfobox
        - contactsBeta
        - paypalIntegration
        - stripeIntegration
        - mollieIntegration
        - meetingTypeTemplates
        - nextBeta
        - video
        - emailLayout
        - reviews
        - brevoIntegration
        - getResponseIntegration
        - customDomain
        - maxCustomDomains
        - maxViewers
        - apiPlatform
        - slackIntegration
        - calgent
        - miraPipelineAutopilot
        - fileUploads
        - knowledgePageLimit
        - storageQuotaMB
        - recordingRetentionDays
        - multiBooking
        - bundles
        - maxCrmDeals
        - maxShowcaseHubs
        - maxDealSpaces
        - waitlist
        - notetaker
        - notetakerRecording
        - maxNotetakerRecapsPerMonth
        - maxLinkedInLookupsPerMonth
        - quickMail
        - enrichDealSpaceCompany
        - whatsappAddon
        - conversionWidgetNativeScheduling
        - instagramDms
        - bookingCoupons
        - crmEmailSync
        - websiteChat
        - emailChannel
        - teamChat
        - aiPhoneAssistant
        - aiPhoneAssistantAdvanced
        - bookingLocations
        - bookingBlocks
        - invoicing
        - purchaseDocuments
        - hostedEvents
        - hostedEventTicketing
        - paymentLinks
        - feedbackLoop
        - newsletter
        - maxFormSubmissionsPerMonth
        - maxSignatureRequestsPerMonth
        - advancedSignatures
        - maxAdvancedSignatureRequestsPerMonth
        - maxInvoicesPerMonth
        - whatsappAiAgent
        - customSmtp
        - csvExport
    MeetingTypeResponseDto:
      type: object
      properties:
        id:
          type: string
        meetingInfo:
          $ref: '#/components/schemas/MeetingInfo'
        meetingOptions:
          $ref: '#/components/schemas/MeetingOptions'
        crmOptions:
          $ref: '#/components/schemas/MeetingCRMOptions'
        ics:
          $ref: '#/components/schemas/IcsInfo'
        timeslotInterval:
          type: number
        spots:
          type: number
        enabled:
          type: boolean
        slug:
          type: string
        bookingMinimum:
          type: number
        connectGuestJoinMinutesBeforeStart:
          type: number
          nullable: true
          minimum: 0
          maximum: 525600
        connectGuestJoinMinutesAfterEnd:
          type: number
          nullable: true
          minimum: 0
          maximum: 525600
        daysIntoFuture:
          $ref: '#/components/schemas/DaysIntoFutureSetting'
        enableCalendarInviteNotification:
          type: boolean
        roundRobin:
          type: array
          items:
            type: string
        useSchedule:
          type: boolean
        useCompanyLogo:
          type: boolean
        useCustomInvite:
          type: boolean
        disableActionButtons:
          type: boolean
        useCustomForm:
          type: boolean
        inCompanyPage:
          type: boolean
        formFirst:
          type: boolean
        locations:
          type: array
          items:
            type: string
        isGlobalQueue:
          type: boolean
        compact:
          type: boolean
        disableTeamsEmail:
          type: boolean
        calendarGuestListVisible:
          type: boolean
        languageSetting:
          $ref: '#/components/schemas/LanguageSetting'
        customTextSelectChannel:
          $ref: '#/components/schemas/CustomTextSelectChannelSetting'
        timezonePreset:
          $ref: '#/components/schemas/TimezonePresetSetting'
        timeFormat:
          allOf:
            - $ref: '#/components/schemas/BookingTimeFormat'
        cssSetting:
          $ref: '#/components/schemas/CssSetting'
        metaSetting:
          $ref: '#/components/schemas/MetaSetting'
        companyId:
          type: string
        createdById:
          type: string
        createdAt:
          type: string
        updatedAt:
          type: string
        deletedAt:
          type: string
        workspaceId:
          type: string
        userId:
          type: string
        formId:
          type: string
        availabilityId:
          type: string
        queueId:
          type: string
        reminderIds:
          type: array
          items:
            type: string
        workspace:
          $ref: '#/components/schemas/WorkspaceBasicDto'
        user:
          $ref: '#/components/schemas/UserBasicDto'
        createdBy:
          $ref: '#/components/schemas/UserBasicDto'
        availability:
          $ref: '#/components/schemas/AvailabilityBasicDto'
        form:
          $ref: '#/components/schemas/FormBasicDto'
        reminders:
          type: array
          items:
            $ref: '#/components/schemas/ReminderBasicDto'
        metadata:
          type: object
          nullable: true
          description: Key-value metadata for integrations
          example:
            ticketId: EVAL-12345
        internalNotes:
          type: string
          nullable: true
          description: Internal note for organizers. Never shown to customers.
        oneTimeLink:
          description: >-
            One-time booking link (only present when requested via
            options.createOneTimeLink)
          allOf:
            - $ref: '#/components/schemas/OneTimeBookingLinkResponseDto'
      required:
        - id
        - meetingInfo
        - meetingOptions
        - crmOptions
        - ics
        - timeslotInterval
        - spots
        - enabled
        - slug
        - bookingMinimum
        - daysIntoFuture
        - enableCalendarInviteNotification
        - roundRobin
        - useSchedule
        - useCompanyLogo
        - useCustomInvite
        - disableActionButtons
        - useCustomForm
        - inCompanyPage
        - formFirst
        - locations
        - isGlobalQueue
        - compact
        - disableTeamsEmail
        - calendarGuestListVisible
        - languageSetting
        - customTextSelectChannel
        - timezonePreset
        - timeFormat
        - cssSetting
        - metaSetting
        - companyId
        - createdById
    CardBlock:
      type: object
      properties:
        id:
          type: string
          description: Client-generated stable id
        type:
          type: string
          enum:
            - headline
            - text
            - link
            - video
            - image
            - file
            - divider
            - faq
            - stats
            - collection
            - form
            - reviews
            - meetingType
        visible:
          type: boolean
        text:
          type: string
          description: Content for headline/text blocks
        url:
          type: string
          description: URL for video, file, link, image, or form blocks
        label:
          type: string
          description: >-
            Display label for file, link, image, collection, form, and reviews
            blocks
        meetingTypeId:
          type: string
          description: Meeting type rendered at this position by a meetingType block
        items:
          type: array
          items:
            $ref: '#/components/schemas/CardBlockItem'
        children:
          type: array
          items:
            $ref: '#/components/schemas/CardBlock'
      required:
        - id
        - type
        - visible
    OnlineProfiles:
      type: object
      properties:
        linkedIn:
          type: string
        facebook:
          type: string
        twitter:
          type: string
        instagram:
          type: string
        xing:
          type: string
        phone:
          type: string
        email:
          type: string
        customLinks:
          type: array
          items:
            $ref: '#/components/schemas/CustomLink'
        addressStreet:
          type: string
        addressCity:
          type: string
        addressPostalCode:
          type: string
        addressCountry:
          type: string
      required:
        - linkedIn
        - facebook
        - twitter
        - instagram
        - xing
        - phone
        - email
        - customLinks
        - addressStreet
        - addressCity
        - addressPostalCode
        - addressCountry
    BusinessCardBackground:
      type: object
      properties:
        type:
          type: string
          enum:
            - solid
            - gradient
            - image
        value:
          type: string
    MeetingInfo:
      type: object
      properties:
        name:
          type: string
          description: Name of the meeting type
        description:
          type: string
          description: Description of the meeting type
        nameLocalised:
          nullable: true
          description: Per-language overrides for the title. Falls back to `name`.
          allOf:
            - $ref: '#/components/schemas/LocalisedContent'
        descriptionLocalised:
          nullable: true
          description: >-
            Per-language overrides for the description. Falls back to
            `description`.
          allOf:
            - $ref: '#/components/schemas/LocalisedContent'
        enableRedirect:
          type: boolean
          description: Enable redirect after booking completion
        redirect:
          type: string
          description: Redirect URL to navigate after booking
        passEventDetailsToRedirect:
          type: boolean
          description: >-
            Pass event details (invitee name, email, form answers) as query
            params to redirect URL
        duration:
          type: number
          description: Primary duration in minutes
        channel:
          description: Meeting channel/location type
          allOf:
            - $ref: '#/components/schemas/MeetingTypeChannel'
        customChannelName:
          type: string
          description: Custom name for the meeting channel
        customChannelLink:
          type: string
          description: Custom link for the meeting channel
        connectChannelName:
          type: string
          description: Custom display name for the connect channel
        groupBooking:
          type: boolean
          description: Enable group booking (multiple attendees per slot)
        showAvailableSlots:
          type: boolean
          description: Show available spots count on the booking page
        enrichInvitee:
          type: boolean
          description: Enable invitee data enrichment
        autoCreateSpace:
          type: boolean
          description: Auto-create a Space when someone books
        spacePresetId:
          type: object
          description: Space preset id used for the auto-created Space
          nullable: true
        spaceAutoInvite:
          type: boolean
          description: Publish the auto-created Space and invite the booker
        confirmationButton:
          description: Confirmation button settings
          allOf:
            - $ref: '#/components/schemas/ConfirmationButton'
        bufferBefore:
          type: number
          description: Buffer time before meeting in minutes
        bufferAfter:
          type: number
          description: Buffer time after meeting in minutes
        bufferMustStayWithinWorkingHours:
          type: boolean
          description: >-
            Only offer slots where buffer fits within working hours (no
            spillover into breaks or after-hours)
        rollingSlots:
          type: boolean
          description: >-
            Restart the slot grid after each appointment instead of keeping a
            fixed grid per working block
        color:
          type: object
          description: Color for the meeting type in RGB format, e.g. "rgb(0, 153, 255)"
          nullable: true
      required:
        - name
        - description
        - enableRedirect
        - redirect
        - passEventDetailsToRedirect
        - duration
        - channel
        - customChannelName
        - customChannelLink
        - connectChannelName
        - groupBooking
        - showAvailableSlots
        - enrichInvitee
        - autoCreateSpace
        - spaceAutoInvite
        - confirmationButton
        - bufferBefore
        - bufferAfter
        - bufferMustStayWithinWorkingHours
        - rollingSlots
    MeetingOptions:
      type: object
      properties:
        allowedDurations:
          description: >-
            Additional duration options in minutes (shown alongside primary
            duration)
          example:
            - 15
            - 30
            - 60
          type: array
          items:
            type: number
        allowSelectChannel:
          type: boolean
          description: Allow attendees to select meeting channel/location
        allowHostSelection:
          type: boolean
          description: Allow attendees to select specific host (round-robin only)
        forceHostSelection:
          type: boolean
          description: Force host selection (no "any host" option available)
        allowedChannels:
          type: array
          description: Available channel options when allowSelectChannel is enabled
          items:
            $ref: '#/components/schemas/MeetingTypeChannel'
        channelAvailabilities:
          type: object
          description: >-
            Per-channel availability overrides. Each value can be a UUID string
            (existing availability) or an inline availability object with
            "name", "timezone", and optional "schedule" and "exceptions" for
            creation.
        allowAddingGuests:
          type: boolean
          description: Allow attendees to invite additional guests
        doubleOptIn:
          type: string
          description: Double opt-in confirmation setting
        requireHostConfirmation:
          type: string
          description: Require host confirmation for bookings
        enableClusterMeeting:
          type: boolean
          description: Show only time slots adjacent to existing meetings
        enableBufferCarryOver:
          type: boolean
          description: Carry over buffer time to next available slot if needed
        maxBufferCarryOverDelay:
          type: number
          description: Maximum hours for buffer carry-over delay (0-168)
        allowPhoneOnlyBooking:
          type: boolean
          description: >-
            Allow phone-only bookings without email (API use case, requires
            phoneOnlyBooking in request)
        hideReassignedHostDetails:
          type: boolean
          description: Hide the previous host's details from attendee reassignment emails
        confirmationPageCssSetting:
          description: Custom CSS settings for confirmation pages
          allOf:
            - $ref: '#/components/schemas/CssSetting'
        bookingPagePassword:
          description: Password protection settings for booking page
          allOf:
            - $ref: '#/components/schemas/BookingPagePasswordSetting'
      required:
        - allowedDurations
        - allowSelectChannel
        - allowHostSelection
        - forceHostSelection
        - allowedChannels
        - allowAddingGuests
        - doubleOptIn
        - requireHostConfirmation
        - enableClusterMeeting
        - enableBufferCarryOver
        - maxBufferCarryOverDelay
        - allowPhoneOnlyBooking
        - hideReassignedHostDetails
        - confirmationPageCssSetting
        - bookingPagePassword
    MeetingCRMOptions:
      type: object
      properties:
        hubspotContactSync:
          type: boolean
        hubspotContactStage:
          type: string
        hubspotCompanySync:
          type: boolean
        hubspotCompanyStage:
          type: string
        hubspotCompanyMatchingField:
          type: string
        hubspotDealSync:
          type: boolean
        hubspotDealStage:
          type: string
        hubspotPipelineId:
          type: string
        pipedriveDealSync:
          type: boolean
        pipedriveContactSync:
          type: boolean
        pipedrivePipelineId:
          type: number
          nullable: true
        pipedriveStageId:
          type: number
          nullable: true
        pipedriveUseExistingDeal:
          type: boolean
        closeDealSync:
          type: boolean
        closeContactSync:
          type: boolean
        closePipelineId:
          type: object
          nullable: true
        closeStatusId:
          type: object
          nullable: true
        closeUseExistingDeal:
          type: boolean
        centralStationContactSync:
          type: boolean
        centralStationDealSync:
          type: boolean
        centralStationPipelineId:
          type: number
          nullable: true
        centralStationStageId:
          type: number
          nullable: true
        linkandoSyncEnabled:
          type: boolean
        linkandoPlaybookId:
          type: number
          nullable: true
        linkandoTemplateId:
          type: number
          nullable: true
        evalancheEnabled:
          type: boolean
        klicktippEnabled:
          type: boolean
        getResponseEnabled:
          type: boolean
        getResponseCampaignId:
          type: string
          nullable: true
        brevoEnabled:
          type: boolean
        sevdeskEnabled:
          type: boolean
        sevdeskCategoryId:
          type: number
          nullable: true
        lexwareEnabled:
          type: boolean
        professionalWorksEnabled:
          type: boolean
        abAgentaEnabled:
          type: boolean
        smartWeContactSync:
          type: boolean
        smartWeCompanySync:
          type: boolean
        smartWeDealSync:
          type: boolean
        smartWeDealStage:
          type: string
        salesforceSyncEnabled:
          type: boolean
        salesforceCaseSync:
          type: boolean
        salesforceLeadSync:
          type: boolean
        salesforceOpportunitySync:
          type: boolean
        salesforceLeadStatus:
          type: string
        salesforceCaseStatus:
          type: string
        salesforceOpportunityStage:
          type: string
        salesforceDefaultObjectType:
          type: string
        internalCrmPipelineId:
          type: object
          nullable: true
        internalCrmStageId:
          type: object
          nullable: true
        crmOptInFieldName:
          type: object
          nullable: true
      required:
        - hubspotContactSync
        - hubspotContactStage
        - hubspotCompanySync
        - hubspotCompanyStage
        - hubspotCompanyMatchingField
        - hubspotDealSync
        - hubspotDealStage
        - hubspotPipelineId
        - pipedriveDealSync
        - pipedriveContactSync
        - pipedrivePipelineId
        - pipedriveStageId
        - pipedriveUseExistingDeal
        - closeDealSync
        - closeContactSync
        - closePipelineId
        - closeStatusId
        - closeUseExistingDeal
        - centralStationContactSync
        - centralStationDealSync
        - centralStationPipelineId
        - centralStationStageId
        - linkandoSyncEnabled
        - linkandoPlaybookId
        - linkandoTemplateId
        - evalancheEnabled
        - klicktippEnabled
        - getResponseEnabled
        - getResponseCampaignId
        - brevoEnabled
        - sevdeskEnabled
        - sevdeskCategoryId
        - lexwareEnabled
        - professionalWorksEnabled
        - abAgentaEnabled
        - smartWeContactSync
        - smartWeCompanySync
        - smartWeDealSync
        - smartWeDealStage
        - salesforceSyncEnabled
        - salesforceCaseSync
        - salesforceLeadSync
        - salesforceOpportunitySync
        - salesforceLeadStatus
        - salesforceCaseStatus
        - salesforceOpportunityStage
        - salesforceDefaultObjectType
        - internalCrmPipelineId
        - internalCrmStageId
        - crmOptInFieldName
    IcsInfo:
      type: object
      properties:
        title:
          $ref: '#/components/schemas/LocalisedContent'
        description:
          $ref: '#/components/schemas/LocalisedContent'
        location:
          $ref: '#/components/schemas/LocalisedContent'
        requireGuestConfirmation:
          type: boolean
      required:
        - title
        - description
        - location
    DaysIntoFutureSetting:
      type: object
      properties:
        mode:
          type: string
        bookingLimit:
          type: number
        countMode:
          type: string
        rangeMin:
          format: date-time
          type: string
        rangeMax:
          format: date-time
          type: string
      required:
        - mode
    LanguageSetting:
      type: object
      properties:
        enable:
          type: boolean
        default:
          type: string
        allowed:
          type: array
          items:
            type: string
      required:
        - enable
        - default
        - allowed
    CustomTextSelectChannelSetting:
      type: object
      properties:
        enable:
          type: boolean
        body:
          type: string
      required:
        - enable
        - body
    TimezonePresetSetting:
      type: object
      properties:
        enable:
          type: boolean
        timezonePreset:
          type: string
      required:
        - enable
    BookingTimeFormat:
      type: string
      enum:
        - '12'
        - '24'
    CssSetting:
      type: object
      properties:
        mode:
          type: number
        themePreset:
          type: string
          enum:
            - light
            - dark
            - eco
            - charcoal
            - bold
      required:
        - mode
    MetaSetting:
      type: object
      properties:
        nextBetaEnabled:
          type: boolean
        title:
          type: string
        body:
          type: string
        image:
          type: string
    WorkspaceBasicDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
      required:
        - id
        - name
        - slug
    UserBasicDto:
      type: object
      properties:
        id:
          type: string
        givenName:
          type: string
        familyName:
          type: string
        picture:
          type: string
        slug:
          type: string
        userType:
          type: string
      required:
        - id
        - givenName
        - familyName
        - slug
        - userType
    AvailabilityBasicDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    FormBasicDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    ReminderBasicDto:
      type: object
      properties:
        id:
          type: number
        name:
          type: string
      required:
        - id
        - name
    OneTimeBookingLinkResponseDto:
      type: object
      properties:
        id:
          type: string
        url:
          type: string
          description: Full URL for the one-time booking page
        meetingTypeId:
          type: string
        createdAt:
          type: string
      required:
        - id
        - url
        - meetingTypeId
        - createdAt
    CardBlockItem:
      type: object
      properties:
        title:
          type: string
        text:
          type: string
      required:
        - title
        - text
    CustomLink:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        icon:
          type: string
      required:
        - name
        - url
        - icon
    LocalisedContent:
      type: object
      properties:
        en:
          type: string
        de:
          type: string
        fr:
          type: string
        es:
          type: string
        'no':
          type: string
        it:
          type: string
        nl:
          type: string
        da:
          type: string
        pl:
          type: string
        se:
          type: string
        tr:
          type: string
      required:
        - en
    MeetingTypeChannel:
      type: string
      enum:
        - local
        - local-attendee
        - google
        - zoom
        - phone
        - phone-incoming
        - whatsapp
        - connect
        - webex
        - skypeForConsumer
        - skypeForBusiness
        - teamsForBusiness
        - teamsForBusiness2
        - teamsForExchange
        - teams2ForExchange
        - custom
        - resource
        - whereby
        - kmeet
        - zava
        - jitsi
        - nextcloudTalk
        - openTalk
        - alfaview
      description: Meeting channel/location type
    ConfirmationButton:
      type: object
      properties:
        useConfirmationButton:
          type: boolean
        text:
          type: string
        color:
          type: string
        link:
          type: string
      required:
        - useConfirmationButton
        - text
        - color
        - link
    BookingPagePasswordSetting:
      type: object
      properties:
        enable:
          type: boolean
          description: Enable password protection for booking page
        password:
          type: object
          description: Password for booking page access
      required:
        - enable
        - password
  responses:
    BadRequest:
      description: >-
        The request did not validate. `message` lists the constraints that
        failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: Missing, malformed, or expired credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Forbidden:
      description: >-
        Authenticated, but not allowed: the plan does not include this feature,
        or the token is scoped away from it.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: >-
        No such resource in your account. Resources belonging to another account
        are reported the same way.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    TooManyRequests:
      description: Rate limited. Back off and retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.