--- title: "GET /invoicing/documents/{id}/payments" method: GET path: "/invoicing/documents/{id}/payments" tags: ["Invoicing Documents"] --- # GET /invoicing/documents/{id}/payments `GET /invoicing/documents/{id}/payments` ## Request - Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from) - URL: `https://developer.meetergo.com/invoicing/documents/{id}/payments` - Auth: one of: - HTTP bearer - HTTP bearer - API key in header `x-meetergo-api-user-id` ## Path parameters - `id` string, required ## Response `200` - DocumentPayment[] - `id` string, required - `documentId` string, required - `companyId` string, required - `amount` number, required - `currency` string, required - `method` 'stripe' | 'paypal' | 'mollie' | 'bank_transfer' | 'cash' | 'other' | 'credit_note', required - `status` 'pending' | 'completed' | 'failed', required - `providerPaymentId` string, nullable: Stripe payment intent id / PayPal order id / Mollie payment id - `paidAt` string, date-time, nullable: Wertstellung: when the money arrived (manual entries may backdate) - `note` string, nullable - `createdByUserId` string, nullable: Set for manually recorded payments; null for provider payments - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `document` SalesDocument - `id` string, required - `kind` 'offer' | 'order_confirmation' | 'invoice' | 'credit_note' | 'cancellation', required - `status` 'draft' | 'finalized' | 'sent' | 'partially_paid' | 'paid' | 'cancelled' | 'accepted' | 'rejected', required - `number` string, nullable: Allocated at finalization; null on drafts (drafts never consume numbers) - `issueDate` string, required - `deliveryDate` string, nullable: Leistungs-/Lieferdatum (§ 14 Abs. 4 Nr. 6 UStG); period start when deliveryDateEnd is set - `deliveryDateEnd` string, nullable: Leistungszeitraum end: set → the document covers a service period (BT-73/BT-74) instead of a single date - `dueDate` string, nullable - `currency` string, required - `buyer` object, required - `language` 'de' | 'en', nullable: Language this document is written in, chosen when the draft is created and frozen with the rest of the snapshot at finalization. Stored per document, not read from settings at render time: re-rendering a finalized invoice must reproduce the PDF the buyer received, and a seller switching their default must not reword documents already sent. null means the document predates document languages, so it renders in German, the only language the module used to speak. - `subject` string, nullable: Betreff shown on the document and as email subject - `headText` string, nullable: Kopf-Text: free text above the line items (sevDesk pattern) - `footText` string, nullable: Fuss-Text: free text below the totals - `note` string, nullable: Free-text document note (also carries the § 19 wording when applicable) - `paymentTermsNote` string, nullable - `deliveryTermsNote` string, nullable: Lieferbedingungen shown on the PDF - `totalDiscountPercent` number, nullable: Gesamtrabatt: document-level percent discount, compounded onto every line at totals/snapshot time - `internalContactUserId` string, nullable: Interne Kontaktperson: company user shown as seller contact (PDF + XML) - `skontoPercent` number, nullable: Skonto: early-payment discount in percent (null = no Skonto offered) - `skontoDays` number, nullable: Skonto: days from issue date within which the discount applies - `depositPercent` number, nullable: Offers only: deposit (Anzahlung) in percent of the gross total. When the buyer accepts the shared offer, a finalized deposit invoice over this share is created automatically (null = no deposit asked). - `taxTreatment` 'standard' | 'tax_free_de' | 'reverse_charge_13b' | 'reverse_charge_18b' | 'intra_community' | 'oss' | 'export' | 'out_of_scope', required - `netTotal` number, required - `taxTotal` number, required - `grossTotal` number, required - `snapshot` object, nullable: Frozen EN 16931 record; set exactly once at finalization - `pdfFileAssetId` string, nullable - `xmlFileAssetId` string, nullable - `finalizedAt` string, date-time, nullable - `publicToken` string, nullable - `onlinePayment` boolean, required: Whether this invoice may be paid through the connected providers (`invoicePayableOnline`): the pay button in mails and reminders AND the methods the pay page offers, so a stale link cannot pay what the mail did not offer. The page link itself stays valid: it is the invoice view (PDF, bank details), which WhatsApp delivery and "copy link" hand out. Off for invoices born from a manual-payment booking whose meeting type asked for it; operational state, so it may change after issue. - `amountPaid` number, required - `paidAt` string, date-time, nullable: When the outstanding amount reached zero - `dunningLevel` number, required - `lastDunningAt` string, date-time, nullable - `dunningPaused` boolean, required: Excluded from dunning auto-send (manual sends stay possible) - `companyId` string, required - `contactId` string, nullable: CRM contact this document belongs to (buyer jsonb stays authoritative) - `crmCompanyId` string, nullable: CRM company the buyer was taken from. The `buyer` jsonb stays authoritative — an issued document must not change because someone later edited the company record. This only records where the address came from, so the editor can offer to pull it again and so a company's documents can be found. - `dealId` string, nullable - `bankAccountId` string, nullable: Which of the seller's bank accounts to print. Null falls back to the single account on invoicing settings, which is what every existing document does. - `appointmentId` string, nullable - `previousDocumentId` string, nullable: Chain reference: offer→invoice conversion, Storno→original - `createdById` string - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable: Soft delete is permitted for DRAFTS ONLY (service-enforced) - `lines` SalesDocumentLineItem[] - `id` string, required - `documentId` string, required - `position` number, required: 1-based order on the document (BT-126) - `productId` string, nullable - `name` string, required - `description` string, nullable: The flat reading of `descriptionHtml`, derived on every write. What leaves the app: drawn into the PDF and emitted as `ram:Description` (BT-154) in the EN 16931 e-invoice, which is plain text by specification. Never store markup here. - `descriptionHtml` string, nullable: The description as authored: a small subset of HTML (bold, italic, underline, links, bullet and numbered lists), mirroring `Product`. The line keeps its own copy rather than reading through `productId`: a document is a frozen record, and editing the catalog entry afterwards must not rewrite what an already-issued invoice says. - `quantity` number, required - `unitCode` string, required: UN/ECE Recommendation 20 code for the XML (C62 piece, HUR hour, ...) - `unit` string, nullable: Display unit on the PDF ("Std.", "Stück"); unitCode stays authoritative - `unitPrice` number, required - `discountPercent` number, required - `taxCategory` 'S' | 'Z' | 'E' | 'AE' | 'K' | 'G' | 'O', required - `taxRate` number, required - `netAmount` number, required: Rounded line net, recomputed by the service on every draft save - `document` SalesDocument (recursive) - `product` Product - `id` string, required - `name` string, required - `description` string, nullable: The flat reading of `descriptionHtml`, derived on every write. Stays the field everything downstream consumes: it is copied onto document lines, drawn into the PDF, and emitted as `ram:Description` (BT-154) in the EN 16931 e-invoice, which is plain text by specification. Never store markup here. - `descriptionHtml` string, nullable: The description as authored: a small subset of HTML (bold, italic, underline, links, bullet and numbered lists). Held alongside rather than replacing `description` because the two have different jobs — this one is for reading and editing in the app, that one is what may legally leave in an e-invoice. - `articleNumber` string, nullable: Optional article number shown on documents (e.g. "A-1023") - `kind` 'service' | 'good', required - `unit` string, nullable: Unit shown on documents (e.g. "Stunde", "Stück", "Pauschale") - `unitCode` string, required: UN/ECE Recommendation 20 code backing the display unit (e-invoice XML) - `unitPrice` number, required: Net unit price. 4 decimal places to support fractional-cent pricing. - `currency` string, required: ISO 4217 currency code - `taxCategory` 'S' | 'Z' | 'E' | 'AE' | 'K' | 'G' | 'O', required - `taxRate` number, required: VAT rate in percent (19.00, 7.00, 0.00) - `active` boolean, required - `companyId` string, required - `meetingTypeId` string - `createdById` string - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable: Soft delete: products stay resolvable from historical document lines - `company` Company - `name` string, required - `slug` string, required - `description` string, required - `logo` string - `language` string, required - `allowedLanguages` string[] - `allowAITranslation` boolean - `timezone` string, required: Company timezone acts as default for new users and other presets. It is set after onboarding is completed to the owner's timezone chosen during onboarding. If not set, it defaults to UTC. If timezone is UTC it may suggest that onboarding was not completed. - `referralId` string - `tier` 'basic' | 'essentials' | 'growth' | 'teams' | 'light' | 'suite' | 'premium' | 'enterprise', required - `subscriptionStatus` 'active' | 'past_due' | 'unpaid' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'trialing', required - `preferredCurrency` 'USD' | 'EUR': User's preferred currency for billing. If null, detected currency from billing address country is used. - `users` string[], required: Comma-seperated IDs of users. - `type` 'solo' | 'team', required: Reflects solo/team choice during onboarding but doesn't affect anything else - `emailSender` 'custom-smtp' | 'microsoft-smtp': Sender to use for sending emails. Defaults to null which uses the default sender. If a sender is configured the configuration must still be fetched. If there is an error with configuration, fall back to default and notify. - `primaryColor` string, required - `useBrandStyling` boolean, required - `hideMeetergoBranding` boolean, required - `businessCardTheme` BusinessCardTheme - `preset` string: Theme preset key, e.g. classic, nocturne - `accent` string: Hex accent color override - `background` BusinessCardBackground - … - `font` 'sans' | 'serif' | 'grotesk' | 'mono' | 'condensed' | 'rounded' - `buttonShape` 'sharp' | 'rounded' | 'pill' - `enforceBusinessCardTheme` boolean, required: When true, the company theme overrides every member's own card design. - `googleAnalyticsMeasurementId` string, nullable: Google Analytics 4 Measurement ID (e.g., G-XXXXXXXXXX) - `gtmContainerId` string, nullable: Google Tag Manager Container ID (e.g., GTM-XXXXXXX) - `gtmServerContainerUrl` string, nullable: Custom server-side GTM loader URL (e.g., https://metrics.example.com/gtm.js). When set, the booking page loads the GTM container from this first-party endpoint instead of googletagmanager.com. - `matomoUrl` string, nullable: Base URL of the company Matomo instance (e.g. https://stats.example.com). Booking pages load the Matomo tracker from here when a Site ID is also set. - `matomoSiteId` string, nullable: Matomo Site ID of the tracked website, as shown in the Matomo UI. - `googleActionsCenterEnabled` boolean, required: Enable Reserve with Google integration - `googleActionsCenterMeetingTypeIds` string[], nullable: Meeting type IDs for Reserve with Google - `connectWaitingRoom` ConnectWaitingRoomSettings - `welcomeText` string: Welcome text shown above the prejoin card - `logoUrl` string: Logo shown on the waiting screen, overrides the company logo - `backgroundImageUrl` string: Full-screen background image behind the prejoin card - `backgroundVideoUrl` string: Muted looping background video behind the prejoin card, takes precedence over the background image - `brandColor` string: Accent color for the join button, hex format - `featureAccess` FeatureAccess, required - `polls` boolean, required - `advancedMeetingTypeSettings` boolean, required - `workflows` boolean, required - `maxWorkflows` number, required: -1 means unlimited - `meetingTypeCommunications` boolean, required - `multiHostBooking` boolean, required - `groupBooking` boolean, required - `enrichInvitee` boolean, required - `autoCreateSpace` boolean, required - `zapier` boolean, required - `personalizedBranding` boolean, required - `visualBranding` boolean, required - `crmIntegration` boolean, required - `cmpIntegration` boolean, required - `routingForms` boolean, required - `basicForms` boolean, required - `selectionPages` boolean, required - `dataFields` boolean, required - `roundRobin` boolean, required - `accountOwnerMatching` boolean, required - `handoff` boolean, required - `reschedule` boolean, required - `notifications` boolean, required - `workspaces` boolean, required - `api` boolean, required - `showcaseHubs` boolean, required - `meetergoConnect` boolean, required - `connectMaxParticipants` number, required - `connectMaxCallMinutes` number, required - `connectRecording` boolean, required - `connectBreakouts` boolean, required - `connectWebinars` boolean, required - `webhooks` boolean, required - `wallets` boolean, required - `dealSpace` boolean, required - `funnel` boolean, required - `unlimitedMeetingTypes` boolean, required - `salesforceIntegration` boolean, required - `salesforceStudioMapping` boolean, required - `salesforceRouting` boolean, required - `maximumCalendars` number, required - `disableIntercom` boolean, required - `supportChat` boolean, required - `evalancheIntegration` boolean, required - `analytics` boolean, required - `bookingFunnel` boolean, required - `funnelProgressAndInfobox` boolean, required - `contactsBeta` boolean, required - `paypalIntegration` boolean, required - `stripeIntegration` boolean, required - `mollieIntegration` boolean, required - `meetingTypeTemplates` boolean, required - `nextBeta` boolean, required - `video` boolean, required - `emailLayout` boolean, required - `reviews` boolean, required - `brevoIntegration` boolean, required - `getResponseIntegration` boolean, required - `customDomain` boolean, required - `maxCustomDomains` number, required - `maxViewers` number, required: -1 means unlimited - `apiPlatform` boolean, required - `slackIntegration` boolean, required - `calgent` boolean, required - `miraPipelineAutopilot` boolean, required - `fileUploads` boolean, required - `knowledgePageLimit` number, required - `storageQuotaMB` number, required - `recordingRetentionDays` number, required - `multiBooking` boolean, required - `bundles` boolean, required - `maxCrmDeals` number, required - `maxShowcaseHubs` number, required - `maxDealSpaces` number, required - `waitlist` boolean, required - `notetaker` boolean, required - `notetakerRecording` boolean, required - `maxNotetakerRecapsPerMonth` number, required - `maxLinkedInLookupsPerMonth` number, required - `quickMail` boolean, required - `enrichDealSpaceCompany` boolean, required - `whatsappAddon` boolean, required - `conversionWidgetNativeScheduling` boolean, required - `instagramDms` boolean, required - `bookingCoupons` boolean, required - `crmEmailSync` boolean, required - `websiteChat` boolean, required - `emailChannel` boolean, required - `teamChat` boolean, required - `aiPhoneAssistant` boolean, required - `aiPhoneAssistantAdvanced` boolean, required - `bookingLocations` boolean, required - `bookingBlocks` boolean, required - `invoicing` boolean, required - `purchaseDocuments` boolean, required - `hostedEvents` boolean, required - `hostedEventTicketing` boolean, required - `paymentLinks` boolean, required - `feedbackLoop` boolean, required - `newsletter` boolean, required - `maxFormSubmissionsPerMonth` number, required - `maxSignatureRequestsPerMonth` number, required - `advancedSignatures` boolean, required - `maxAdvancedSignatureRequestsPerMonth` number, required - `maxInvoicesPerMonth` number, required - `whatsappAiAgent` boolean, required - `customSmtp` boolean, required - `csvExport` boolean, required - `detectedCurrency` 'USD' | 'EUR', required: User's preferred currency for billing. If null, detected currency from billing address country is used. - `effectiveCurrency` 'USD' | 'EUR', required: User's preferred currency for billing. If null, detected currency from billing address country is used. - `useNoReplyAddress` boolean, required - `sendEmailsAsPlainText` boolean, required: When enabled, outgoing emails for this company are sent as plain text instead of HTML. The HTML body is converted to text and replaces the payload; templates and React Email layouts are still rendered first and then stripped. Used by customers whose mail servers/recipients mangle rich HTML or who need accessibility/compliance-grade plain messages. - `integrationPermissions` object: Granular per-integration permissions. Controls which integrations are available to company members. Workspace-level overrides can further refine these settings. - `outlookConnectionRequirementScopes` OutlookConnectionRequirementScope[], required: Where the "host needs a working Microsoft connection" requirement applies. Empty array = no enforcement. See `OutlookConnectionRequirementScope` for the meaning of each scope. Default empty for backwards compatibility. - `outlookConnectionRequirementTypes` OutlookConnectionType[], required: Which Microsoft connection types are accepted as "active" when any scope in `outlookConnectionRequirementScopes` is enabled. A host needs at least one matching active connection. Defaults to both Graph and Exchange Teams. - `storageUsedBytes` number, required: Total storage used by this company in bytes. Updated when files are uploaded or deleted. - `defaultLandingPage` string, nullable: Company-level setting for the default page users see after login. When null, defaults to /meeting-types. - `miraSettings` MiraSettings - `enabled` boolean, required - `activationPromptSeen` boolean, required - `dataAccess` MiraDataAccess, required - … - `webChat` MiraWebChat, required - … - `assistantProfiles` MiraAssistantProfile[], required - … - `lastTestDrive` MiraTestDrive - … - `channels` MiraChannels, required - … - `customInstructions` string, required - `dealAutopilot` MiraDealAutopilot, required - … - `id` string, required - `usersRelation` User[] - `zoomEncryptionType` object: Zoom meeting encryption type preference. - 'enhanced_encryption': Allows web browser joining (recommended) - 'e2ee': End-to-end encryption, requires Zoom client - null: Use Zoom account default settings - `timezone` string, required: User timezone affects times shown in notifications, UI etc. It is set to the chosen timezone after onboarding is completed. `utc` timezone may suggest that onboarding was not completed yet or for the user. - `language` 'en' | 'de' | 'fr' | 'es' | 'no' | 'nl' | 'it' | 'pl' | 'se' | 'tr' | 'da', required - `seatTier` 'basic' | 'essentials' | 'growth' | 'teams' | 'light' | 'suite' | 'premium' | 'enterprise': The tier this seat is billed and entitled at, when it is lower than the company's own. `null` — the overwhelming majority, and every user that existed before this was added — means the seat simply follows the company tier, which is how billing worked when there was only one tier per account. A value here pins the seat lower: a Suite or Premium account should not have to buy Suite for a colleague who only books meetings. Only ever below the account tier. Nothing here can raise a seat above what the company pays for, because entitlements are the intersection of the two (see `mergeSeatAccess`). - `viewerScope` 'company' | 'teams': How much a {@link UserType.VIEWER} may read. Ignored for every other type. `company` sees the whole account, `teams` only the members of the workspaces they are assigned to via `analyticsViewerWorkspaces`. Explicit rather than inferred from "has any assigned workspace": an admin who creates a team-scoped viewer and has not picked the teams yet would otherwise be handing out company-wide access by omission. A `teams` viewer with nothing assigned sees nothing, which is the safe end of that mistake. - `notetakerEnabled` boolean, required: Send the notetaker to this host's meetings unless something more specific says otherwise. The bottom of the chain — a meeting type or a single meeting can still override it in either direction. Defaults to false and must stay that way: the bot is a visible third participant recording people who did not book the call, and Germany is a two-party-consent country. Recording is something a host turns on. - `notetakerRecordExternal` boolean, required: Whether the notetaker also covers meetings read off this host's connected calendars, or only meetergo bookings. On by default, which keeps today's behaviour: switching the notetaker on has always meant the whole calendar. Off narrows `notetakerEnabled` to bookings — and stops the calendar mirror storing this host's external meetings at all, so the narrower choice is also the more private one. Meaningless while `notetakerEnabled` is false. - `notetakerLanguage` 'en' | 'de' | 'fr' | 'es' | 'no' | 'nl' | 'it' | 'pl' | 'se' | 'tr' | 'da' - `notetakerEmailTranscript` boolean, required: Mail this host the recording when it is ready. On by default, which is the opposite of `notetakerEnabled` above and for a different question. That switch decides whether a bot joins somebody else's call, so its absence has to read as no. This one decides whether a host gets their own recording in their own inbox after they already asked for it, and a host who switched recording on and hears nothing afterwards assumes it did not work. The mail goes to the host alone and carries the summary and a link, never the transcript itself or a copy to the other people on the call: those are decisions about somebody else's words, and they belong to a sharing action rather than to a default. - `notetakerAdvanceNotice` boolean, required: Email attendees ahead of this host's recorded meetings. On by default: the advance notice is the disclosure attendees get when nothing else reaches them, so silence is something a host opts into, not something that happens to them. Off only quiets the dedicated advance email — the confirmation footer, the calendar sentence and the notice in the meeting itself are not this setting's to remove. - `preCallBriefEmail` boolean, nullable: Email me the pre-call brief before each of my meetings. Three states, not two. Null means the host has never answered, so the workspace's own default decides; true and false are the host overriding it either way. Without the null an admin switching the workspace on could never reach anybody, because every existing row would already read as a deliberate "no". - `meetingTypes` MeetingType[]: Meeting types that user owns - … - `meetingTypeTemplates` MeetingTypeTemplate[] - … - `availabilities` Availability[]: Availabilities that user owns - … - `appointments` Appointment[] - … - `mainHostAppointment` Appointment[] - … - `workspaces` Workspace[] - … - `bookingLinkMeetingType` MeetingType - … - `calgentRequireApproval` boolean, required: Hold every booking for the host to allow before it reaches the calendar. Off by default: the assistant exists to remove the back and forth, and approval puts a step back in. On for hosts who want the assistant to negotiate but not to commit. - `id` string, required: Must be uuid of existing cognito user, i.e. from token `payload.sub`. All values in this row are valid UUIDs, but it is improperly typed as varchar. It should be "uuid". Migrating all values to uuid works without issues, but ALL FKs have to be rewritten as well. - `companyId` string, nullable: Always defined as company is now created immediately upon registration. Only undefined when user is initially created. Can refactor to be non nullable but need to refactor RegisterController as well. - `company` Company (recursive) - `activeCompanyId` string, nullable: Which company this user is currently operating in, for users who hold memberships in companies other than their own (partner admins). Server-owned on purpose. This used to live in the browser's localStorage and ride every request as an `x-meetergo-company-id` header, which meant the client asserted its own authorization context: a value left behind by an earlier session kept being sent, the api refused every request with it (including `/me`), and the app could not boot far enough to correct itself. Nothing could reconcile it, because nothing but the browser knew it existed (reported 2026-08-18). Null means "my own company". A value here is a preference, never a permission: membership is re-validated on every request and this column is cleared when it no longer holds. - `email` string: Email of the user. Email is null when user is a resource. If resource is converted to user, email is set. - `contactEmail` string, nullable: Verified contact email shown to attendees (Reply-To on booking confirmations). When set, it overrides `email` for outbound mail but does not affect auth/login. Required for OAuth users who cannot change `email` via Cognito but want a different customer-facing address. Verified via OTP before being stored. - `isAdmin` boolean, required - `groups` Group[]: Groups the user is in - … - `groupsAdmin` Group[]: Groups the user is admin and in - … - `familyName` string, required: Family name/lastname - `givenName` string, required: Given name/firstname. In the case of Resource, this is resource name - `picture` string: Ful url to user picture hosted statically - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, date-time, nullable - `lastLoginAt` string, date-time, nullable - `lastApiActivityAt` string, date-time, nullable: Last time a programmatic API call (PAT or API key) resolved to this user. The "≥1 API call attributed to the user" signal for reseller seat-activity billing (Placetel contract §4.2) — the limb that bookings and `lastLoginAt` don't cover for API-driven seats. Stamped best-effort on PAT/API-key auth; the write is a conditional UPDATE that no-ops after the first of the day. - `onboardingQualifiedAt` string, date-time, nullable: First qualifying onboarding action (meeting-type / availability / workflow configuration) within 72h of signup. Write-once, claimed via a conditional UPDATE so the `onboarding_qualified` analytics event and its consent-gated Meta CAPI dispatch fire exactly once per user. - `title` string, required - `anonymousBooking` boolean, required - `exemptFromOutlookConnectionRequirement` boolean, required: When true, this host is exempt from the company-wide Microsoft/Outlook connection requirement and stays bookable even without a working connection. Set per host by a company admin. See `isHostEligibleUnderOutlookRequirement`. - `anonymousCalendarActivity` boolean, required - `keepCancelledCalendarEvents` boolean, required: When true, cancelling an appointment keeps the synced calendar event in the host's calendar instead of deleting it: the event is marked cancelled (title prefixed, e.g. "Abgesagt: …") and set to free/transparent so it no longer blocks availability. Lets hosts keep a record of cancelled meetings for time tracking. Default off preserves the historic delete behavior. Honored by `CalendarSyncService.syncAppointmentCancel`. - `slug` string, required - `showGettingStartedList` boolean, required - `recieveEmailMarketing` boolean, required: User opted in to recieve marketing emails - `miraBudgetOverride` number, nullable: A per-seat monthly AI spend cap (USD) that replaces the one their plan tier would give them, set by an operator from the ops console. The tier caps in `MIRA_TIERS` are deliberately tight, so a heavy but legitimate user can exhaust one mid-month and silently drop to the free model lane. This is the lever that fixes that case without a deploy and without moving every other customer on the same plan. Null — everyone, normally — means the seat follows its tier. It is stored here rather than on the LiteLLM customer row because both gateways reconcile that row back to the tier value on every request; this column is what they reconcile *to*. - `miraBudgetOverrideUntil` string, date-time, nullable: When the override lapses back to the tier cap. Null means it does not. Evaluated on read, so no job is involved: an expired override simply stops being returned, and the next request reconciles the gateway back down. - `miraBudgetOverrideReason` string, nullable: Why the operator raised it. Shown in the ops console beside the value. - `userStatus` object, required - `referralId` string - `personalPage` PersonalPage, required - … - `metadata` UserMetaData - … - `calendarSyncProviders` CalendarSync, required - … - `enableHostMeetingLimits` boolean, required - `hostMeetingLimits` object, nullable - `analyticsViewerWorkspaces` Workspace[]: Workspaces this user is an analytics-only viewer of (see `Workspace.analyticsViewers`). Grants scoped analytics, no edit rights. - … - `reminders` Reminder[] - … - `queues` Queue[] - … - `queueUserGroups` QueueUserGroup[] - … - `forms` Form[] - … - `googleConnections` GoogleConnection[] - … - `caldavConnections` CaldavConnection[] - … - `webexConnection` UserWebexConnection - … - `kmeetIntegration` KMeetIntegration - … - `nextcloudTalkIntegration` NextcloudTalkIntegration - … - `openTalkIntegration` OpenTalkIntegration - … - `alfaviewIntegration` AlfaviewIntegration - … - `graphConnections` UserGraphConnection[] - … - `exchangeTeamsConnections` ExchangeTeamsConnection[] - … - `linkandoConnection` LinkandoConnection - … - `smartWeCalendarConnections` SmartWeCalendarConnection[] - … - `exchangeConnections` UserExchangeConnection[] - … - `appleConnections` UserAppleConnection[] - … - `salesforceUserMappings` SalesforceUserMapping[] - … - `salesforceAutoConnectOptOut` boolean, required: This member disconnected their Salesforce calendar themselves. Disconnecting deletes the mapping row, which leaves nothing to tell the company-wide auto-connect apart from a member it has never seen. Without this flag it would re-create the mapping on its next run and the member could not stay disconnected. Connecting again clears it. - `defaultAvailability` Availability - … - `defaultAvailabilityId` string - `aircallUserId` string - `phone` string: Phone number in profile. Migrated from cognito. - `userType` 'standard' | 'resource' | 'api-platform' | 'partner' | 'viewer', required - `provisionalBookings` ProvisionalBookingPayload - … - `resourceChannels` ResourceChannel[], required - … - `calgentActive` boolean, required: Calgent AI email bot settings - `calgentMeetingTypeId` string, nullable - `marketingUnsubscribeToken` string, nullable: Opaque handle for one-click unsubscribe links in marketing email. Nullable and minted on first use rather than defaulted, so adding it does not rewrite the whole `user` table. Not the user id: an unsubscribe link is clicked from an inbox and forwarded around, and it should not hand out an identifier the rest of the API takes seriously. - `calgentMeetingType` MeetingType - … - `instantBookerMeetingTypeId` string, nullable: Hidden meeting type used by the Instant Booker's "Quick Meeting" mode. Created lazily on first use via POST /booking/instant-booker-meeting-type. - `instantBookerMeetingType` MeetingType - … - `alreadyTriedSlugs` string[], required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, date-time, nullable - `owner` string, required - `emailDomain` string: Top level domain of email address Only used for team type companies If undefined, public email is used which can be considered as solo user initially - `cancelsAt` string, date-time: If subscription is canceled, date is set to cancelation date. Null if not canceled. - `stripeCustomerId` string - `stripeSubscriptionId` string, nullable - `prorationBehaviorCreateProration` boolean, required: How proration is handled in stripe. Default is false, which corresponds to `always_invoice`, which bills subscription changes immediately. If set to true, use `create_prorations`, which bills on the next invoice. Currently this is only set manually for enterprise clients with SLA. - `samlIdp` string: Defined if company uses enterprise SSO. This is the identifier passed to cognito. A SAML IDP must be created in cognito. Currently this is only set manually for enterprise clients. - `requireMfa` boolean, required: Every member must sign in with a second factor. Enforced through Keycloak required actions (`MfaEnforcementService`): members without an authenticator app or passkey are made to enroll at their next login. Never set on a company with `samlIdp`; their identity provider owns MFA. - `billingAddress` CompanyBillingAddress, required - `companyName` string, required - `country` string, required - `addressLine1` string, required - `addressLine2` string, required - `city` string, required - `postalCode` string, required - `vatNumber` string, nullable - `lifetimePremium` boolean, required - `trialEndDate` string - `onboardingTrialExtendedAt` string, date-time, nullable, required: Server-owned redemption marker. Shared by all users and onboarding links. - `showTrialOverModal` boolean, required - `maxUsers` number, required - `maxPartners` number, required: Maximum number of partner **users** allowed for this company. NOTE: "Partner users" here are a seat role inside a Company — they don't count toward seat limits and can't access billing or host events. This is NOT the `Reseller` concept (an external organisation that provisions meetergo accounts). See `resellerId` for that relation. - `showDataPolicyLink` boolean, required - `hideDataPolicyCheckbox` boolean, required - `enableWithdrawalFunction` boolean, required: Master switch for the statutory withdrawal function (§ 356a BGB, from 19.06.2026). Publishes the public withdrawal page, the embed widget and the "Vertrag widerrufen" link in the booking pages' legal footer. Which bookings actually offer a withdrawal button is scoped per meeting type via `MeetingType.enableWithdrawalButton`, because only paid B2C distance contracts carry the statutory right. - `withdrawalIntroText` string, nullable, required: Replaces the opening sentence of the public withdrawal page. Null keeps the built-in one, which is translated into every booking language; a custom text is shown as typed, in whatever language it was written, the same trade-off `customLegalText` already makes. Exists because the built-in sentence states the statutory 14 days as fact, and a trader who grants longer is then bound by a period their own page contradicts. Validated against {@link findShortenedWithdrawalPeriod} so the escape hatch cannot be used to announce a shorter one. - `withdrawalPolicyLink` string, nullable, required: The trader's own Widerrufsbelehrung, linked under the intro text. The alternative to restating the terms on our page: link them where they are already maintained. - `dataPolicyLink` string, nullable, required - `imprintLink` string, nullable, required - `hideEmptyWeekend` boolean, required - `useFormalBookingLanguage` boolean, required - `allowAttendeeDataDeletion` boolean, required - `allowNotetakerRecording` boolean, required: Whether anyone in this workspace may have the notetaker record a meeting. A gate, not a default: it only ever subtracts. An admin closes it and no host, meeting type or single meeting in the workspace can reopen it, which is what makes it usable as the compliance control it exists to be. There is deliberately no "record everything" direction — the bot is a visible third participant recording people who never signed up for meetergo, and Germany is a two-party-consent country, so switching recording *on* stays a decision each host makes for their own calls. Default true because closing it is the exceptional act; the entitlement above it and the host default below it both already start at "no". - `preCallBriefEmailDefault` boolean, required: Whether hosts here are emailed their pre-call brief unless they say otherwise. The workspace's answer, which a host can override either way. Default false so no existing workspace starts mailing briefs because a release shipped; an admin turning it on is the deliberate act that starts it. - `notetakerBotName` string, nullable: What the notetaker is called in the participant list, or `null` for ours. Identity rather than configuration: the name is the notice everyone on the call who never booked anything actually receives, and on a customer's own call our brand names the wrong company. Null means the platform default, so a workspace that never thought about it still discloses something a participant can check against the list. Validated on the way in ({@link parseBotName}) rather than at dispatch: a name the capture backend refuses would fail minutes before the meeting, with nobody watching. - `metadata` CompanyMetaData - `companySize` string - `tutorialSteps` CompanyTutorialSteps - … - `campaignPriority` string - `preferences` string[] - `crmCustomFields` CrmCustomField[] - … - `partner` string: Identifies the partner integration that provisioned this company (e.g. 'placetel'). Set by the partner provisioning endpoint. - `trialExtended` boolean: Set to true when the trial was manually extended (e.g. after a customer replied "VERLÄNGERN" to a trial-ending email). Used as a Brevo contact attribute to gate the post-extension email sequence. - `industry` string: Suite vertical picked (or detected) during onboarding, e.g. 'healthcare'. - `website` string: Company website domain collected during onboarding. - `enabledApps` string[]: Suite apps the admin selected during onboarding. New members inherit this as their default sidebar; each user can personalize via user.metadata.suiteApps. - `brokerIntegrationRequest` object - … - `onboarding` object - … - `customBookingCSS` string, required - `customConfirmationPageCSS` string, required - `isSoloFeaturesUnlocked` boolean, required - `metaPixelId` string, nullable - `tiktokPixelId` string, nullable - `usercentricsSettingsId` string, nullable: Usercentrics CMP Settings-ID. Presence = integration connected. - `usercentricsConfig` object, nullable: Options for the Usercentrics integration (validated jsonb, see parseUsercentricsConfig). - `appointmentDeleteTimer` number, nullable, required: Time in minutes. Default 90 days - `forms` Form[] - `id` string, required - `name` string, required - `title` object, required: Title to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `actionButtonText` object, required: Button text to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `blockedEmails` string[], required - `fields` FormField[], required - … - `funnelSteps` FunnelStep[], required - … - `default` boolean, required: Indicates default form that can be modified, but should not be deleted - `funnelConditions` FunnelQualifier[], required - … - `useFullName` boolean, required - `skipForm` boolean, required - `showProgressBar` boolean - `useMeetingTypeSelection` boolean, required - `selectMeetingTypes` MeetingType[], required - … - `selectMeetingTypeOrder` string[]: Stores the order of meeting types for selection pages. If empty/null, use default order from selectMeetingTypeIds. - `selectionPageLayout` 'grid' | 'list' | 'cards' | 'tiles' | 'spotlight' | 'minimal' | 'showcase', required - `selectionPageDescription` object, required: Intro text shown under the selection page title, per language code. - `selectionPageSocialLinks` object, required: Social and contact links shown on the selection page. - `meetingType` MeetingType - … - `meetingTypeTemplate` MeetingTypeTemplate - … - `standaloneKind` 'routing' | 'selection' | 'locationFinder': Explicit discriminator for standalone public experiences. Null preserves the legacy relation-based classification during the mixed-version rollout. - `qualifiers` Qualifier[] - … - `workspace` Workspace - … - `formTheme` FormTheme - … - `structureType` 'FORM_ONLY' | 'FUNNEL_WITH_FORM' | 'FUNNEL_ONLY', required: slug used in routing form only. - `sendRoutingFormSubmissionNotification` boolean, required - `notificationUserId` string, nullable - `notificationEmail` string, nullable - `contactTags` string[], required: Tags written onto the contact a submission creates or updates. Additive: a submission never removes a tag. This is where a newsletter audience grows by itself, and where a sequence trigger gets its tag from (`functions/contact-tags.ts`, configured in the Newsletter app). - `marketingConsentDoubleOptIn` boolean, required: Whether a ticked marketing-consent field is only recorded after the contact confirms it from their inbox. Off: the tick itself is the consent. On: the submission sends a confirmation mail and the ledger row is written when its link is used (`FormMarketingConsentService`). - `redirectAfterSubmission` boolean, required - `redirectUrl` string, nullable - `allowSaveAndReturn` boolean, required - `prefillLock` PrefillLock - … - `salesforceAccountMatch` SalesforceAccountMatch - … - `showCompanyLogo` boolean, required - `webhookUrl` string, nullable - `cssWorkspaceId` string, nullable: Which workspace's CSS to use when cssSetting.mode is Company. If null, falls back to the form's own workspace, then company CSS. - `hasPassword` boolean, required - `submissionDeadline` string, date-time, nullable - `maxSubmissions` number, nullable - `defaultRecipientExpiryDays` number, nullable - `allowRecipientResubmission` boolean: Whether a personal recipient link may be submitted more than once. False (the default) is the survey/one-response-per-person shape: the second submission through the same link is refused. True is the shape where a form carries several outcomes a recipient reaches on separate visits (book a call now, sign the contract later), so the answers may come again. This governs ANSWERS only. The outcomes the platform itself owns stay once-per-recipient either way: a signature cannot be collected twice (`assertSignatureNotCollected`) and an active booking is not made twice (`assertNoActiveRecipientBooking`). Those are properties of the outcome, not preferences of the form. - `publishedAt` string, date-time, nullable - `requiresPublish` boolean, required: New v2-created forms set this true: the form is not publicly visible until its first publish. Existing forms stay false (grandfathered: the live entities keep serving until the owner first publishes). - `allowCopy` boolean, required: Opt-in gate for copying this form's structure. Default false: a public link does NOT make a form copyable. Owner must turn this on (or publish to the marketplace, which implies consent). Enforced in the import path and the marketplace "use template" path. Stops the one-click clone; it cannot stop someone manually recreating fields off the public page. - `marketplaceStatus` 'none' | 'pending' | 'approved' | 'rejected', required: Marketplace lifecycle. Only `approved` forms appear in the public read API and the in-app gallery. See {@link MarketplaceStatus}. - `marketplaceOfficial` boolean, required: "by meetergo" curated form. Operator-set. Controls badge + sort order. - `marketplaceCategory` string, nullable: Category slug for marketplace filtering (e.g. "lead-gen", "recruiting"). - `marketplaceDescription` string, nullable: Public listing description used for the gallery card and SEO copy. - `marketplaceListedAt` string, date-time, nullable: When the form was first approved/listed in the marketplace. - `marketplaceUseCount` number, required: How many times this form has been copied from the marketplace. - `reminders` Reminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `blockEmails` boolean, required - `fieldIds` string[], required - `funnelStepIds` string[], required - `disableModalInEmbed` boolean, required - `language` string, nullable: Language of the public form's own wording (buttons, placeholders, date pickers). Null follows the company language, which is what every form did before this column; set it when a form's questions are in another language, as a PDF import in German for an English account. - `selectMeetingTypeIds` string[], required - `meetingTypeId` string - `meetingTypeTemplateId` string - `locationFinderId` string, nullable, required - `locationFinderVersionId` string, nullable, required - `companyId` string, required: Shouldn't be nullable? - `qualifierIds` string[], required - `workspaceId` string, nullable - `userId` string - `crmOptions` MeetingCRMOptions, required - … - `cssSetting` CssSetting, required - … - `slug` string - `reminders` Reminder[] - `meetingTypes` MeetingType[] - … - `meetingTypeTemplates` MeetingTypeTemplate[] - … - `forms` Form[] - … - `pipelines` Pipeline[] - … - `workspace` Workspace - … - `scheduledReminders` ScheduledReminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` number, required - `name` string, required - `enabled` boolean, required - `scope` object, required - `triggers` ReminderTrigger[], required - … - `companyId` string, required - `workspaceId` string - `userId` string: Maybe shouldnt be nullable - `meetingTypes` MeetingType[] - `meetingInfo` MeetingInfo, required - … - `meetingOptions` MeetingOptions, required - … - `timeslotInterval` number, required - `spots` number, required - `enabled` boolean, required - `isHidden` boolean, required: Marks meeting types that should be hidden from user-facing UIs. Used for system-generated meeting types (e.g., calgent auto-bookings). When true: - Not shown in meeting type lists (filtered in all queries) - Cannot be directly edited by users via UI - May be managed by automated processes - `slug` string, required - `bookingMinimum` number, required: Time in minutes. Default 30 mins - `roundRobin` string[], required: Used to store user latest booked host ids Last element - lastest booked host There shouldn't be duplicates - `schedule` WeeklySchedule, required - … - `hideAddressField` boolean, required: Hide address field for LOCAL_ATTENDEE channel type - `form` Form - … - `emailQualityGuard` boolean, required: Email Quality Guard - Blocks disposable emails and verifies email addresses exist Only applies when formFirst is enabled (Lead Capture Mode) - `enableWaitlist` boolean, required - `connectGuestJoinMinutesBeforeStart` number, nullable: Guest may enter this many minutes before a scheduled Connect call. - `connectGuestJoinMinutesAfterEnd` number, nullable: Guest may enter until this many minutes after a scheduled Connect call. - `runAsWebinar` boolean, required: Run bookings of this meeting type as a Connect webinar (roles, view-only attendees, moderated Q&A, attendance reporting) instead of an ordinary meeting. Only applies when `meetingInfo.channel` is CONNECT. Default false, so every existing meeting type keeps producing ordinary Connect meetings. - `webinarDefaults` object, nullable: Default webinar policy stamped onto each booking's Connect room. Null means the product defaults. Only read when `runAsWebinar` is on. - `notetakerRecording` 'on' | 'off', nullable: Whether the notetaker joins bookings of this meeting type. Null means the host's own default decides — which is not the same as `off`, and is why this is not a boolean. Stored as `varchar` rather than a Postgres enum for the same reason the notetaker's other vocabularies are: adding a word must never need a migration that locks a table. - `availability` Availability - … - `tags` string[], nullable: User-defined tags for organizing meeting types in the dashboard. Free-form strings, OR semantics for filtering. Mirrors the contact tags pattern. - `appointments` Appointment[] - … - `qualifiers` Qualifier[], nullable - … - `reminders` Reminder[] - … - `formMeetingTypes` Form[] - … - `locations` string[], required - `bookingFrequencies` BookingFrequency[]: @todo this doesn't need to be OneToMany and maybe not even a relation (unless different frequencies per user for a queue are needed) - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `timeFormat` '12' | '24', required - `provisionalBookings` ProvisionalBookingPayload[] - … - `accountOwnerMatchingEnabled` boolean, required: Account-owner matching: route a round-robin booking to the user who already owns the booker's account. Owner is resolved via past meetergo bookings + connected CRMs (Pipedrive, HubSpot, Salesforce). Requires `featureAccess.accountOwnerMatching` (Premium). - `accountOwnerMatchingScope` object, required: Where to draw the eligible-owner pool from. Picks one scope per meeting type (no inheritance). - `meetingType`: uses `accountOwnerMatchingUserIds` below - `workspace`: every active member of the meeting type's workspace - `company`: every active member of the meeting type's company - `accountOwnerMatchingUserIds` string[], required: Eligible owners when scope is `meetingType`. Ignored otherwise. - `accountOwnerMatchingAllowNonQueueHosts` boolean, required: If false (default), matched owners must also be queue members for the round-robin to route to them. If true, a matched pool user can host even when not in the queue. - `accountOwnerMatchingFallback` object, required: Behaviour when no owner matches (or matched owner has no slots). - `normalRoundRobin`: fall back to standard host availability - `showEmpty`: show no slots - `salesforceHostPoolEnabled` boolean, required: Draw the bookable hosts for this meeting type from Salesforce instead of from the statically configured queue: the booking page supplies an account key, and the pool is the account's team as {@link salesforceHostPool} describes it. The resolved pool is applied as a queue subset, so round-robin, fairness and host validation all keep working on it unchanged. Every failure — no connection, no match, timeout, nobody left after filtering — falls back to the full queue. Wrong advisor is recoverable in the CRM, a lost lead is not. Requires `featureAccess.salesforceRouting`. - `salesforceHostPool` SalesforceHostPoolSetting - … - `internalNotes` string, nullable: Internal note for organizers. Never shown to customers. Used for project keys, partner info, briefing notes, etc. - `replyTo` string, nullable: Override the Reply-To address for notification emails sent for this meeting type. When set, takes precedence over the company `useNoReplyAddress` flag and the default host email fallback. Useful for sales/support teams that want replies routed to a shared inbox instead of the individual host. - `enableWithdrawalButton` boolean, required: Show the EU/German withdrawal button ("Widerrufsbutton") on the booking confirmation page. Required from 19 June 2026 (§ 356a BGB) for B2C distance contracts with a right of withdrawal. Off by default. Hosts must opt in per meeting type. Disable for leisure-services tied to a fixed date (concerts, events) which are exempt under § 312g Abs. 2 Nr. 9 BGB. - `id` string, required - `activationSessionId` string, nullable, required - `activationResourceKey` string, nullable, required - `crmOptions` MeetingCRMOptions, required - … - `ics` IcsInfo, required - … - `daysIntoFuture` DaysIntoFutureSetting, required - … - `enableCalendarInviteNotification` boolean, required: New notification setting - use calendar invites instead of email notifications. When this option is enabled, booking confirmation notification and cancellation notification are handled by calendar connection. A google/outlook connection is required. It will be used to create calendar invite with notification. All meeting types pre-migration use email notifications. Introduced in order to mitigate duplicate invites, cancellation handling in calendar and overall improve both host and attendee experience. - `useSchedule` boolean, required: Override individual host's availability If true, availability selected for that meeting type will be used as common availability for all hosts. Move to meetingOptions? - `useCompanyLogo` boolean, required: Move to meetingOptions? - `useTeamLogo` boolean, required: Show team logo instead of company logo (for queue/round-robin meeting types) - `useCustomInvite` boolean, required: Move to meetingOptions? - `disableActionButtons` boolean, required: Move to meetingOptions? - `showConfetti` boolean, required: Whether to show confetti animation on the confirmation page - `useCustomForm` boolean, required - `formId` string - `inCompanyPage` boolean, required - `formFirst` boolean, required: Move to meetingOptions? - `communicationSettings` CommunicationSettings - … - `communicationSettingsId` number, nullable, required - `availabilityId` string - `companyId` string, required: Not null - `isFavorite` boolean: Computed at query time per user — not persisted on the entity. Populated by the list endpoint via a join with meeting_type_favorite. - `queue` Queue - … - `queueId` string: Not real value as queue is owner - `oldQueues` Queue[] - … - `reminderIds` string[], required - `workspace` Workspace - … - `workspaceId` string - `isGlobalQueue` boolean, required: If true, meeting type is round robin/collective, which means it has a queue. However, it doesn't belong to a workspace, so it is available to the whole company. May not be needed but using explicit value for clarity for now. - `user` User - … - `userId` string, nullable - `createdBy` User - … - `createdById` string, required - `compact` boolean, required - `disableTeamsEmail` boolean, required: If enabled, booking confirmation email won't be sent for Microsoft Teams meeting - `calendarGuestListVisible` boolean, required: Whether guests on the synced calendar event can see each other. Off by default so strangers on a group booking never see each other's address; on for teams that invite colleagues and known contacts who expect a normal shared invite. Only Google honours it; Outlook has no such flag. - `languageSetting` LanguageSetting, required - … - `customTextSelectChannel` CustomTextSelectChannelSetting, required - … - `timezonePreset` TimezonePresetSetting, required - … - `cssSetting` CssSetting, required - … - `meetingPaymentInfo` MeetingPaymentInfo, required - … - `template` MeetingType (recursive) - `templateId` string, nullable - `lockedFields` string[], required: Field keys locked by the template admin. Copied from the template during assignment and push. Users cannot modify fields in locked sections. - `metaSetting` MetaSetting, required - … - `metadata` object, nullable: Custom key-value metadata for API integrations. Similar to Stripe's metadata field. Included in webhook payloads. - `importSource` string: Defined if imported from another provider. Currently mainly statistical purpose. - `videoSetting` VideoSetting, required - … - `cancellationPolicy` CancellationPolicySetting, required - … - `reschedulingPolicy` ReschedulingPolicySetting, required - … - `recurringSetting` RecurringSetting, required - … - `enableEmailBookingLimit` boolean, required - `maxBookingsPerEmail` number, nullable - `emailBookingLimitPeriod` object - `emailBookingLimitPeriodCount` number, nullable: How many `emailBookingLimitPeriod` units the limit spans, so a window like "6 months" is expressible. Null or 1 counts from the calendar boundary; above 1 counts back from now. See `email-booking-limit-window.ts`. - `resourceChannels` ResourceChannel[] - … - `meetingTypeTemplates` MeetingTypeTemplate[] - `meetingInfo` MeetingInfo, required - … - `meetingOptions` MeetingOptions, required - … - `timeslotInterval` number, required - `spots` number, required - `bookingMinimum` number, required: Time in minutes. Default 30 mins - `schedule` WeeklySchedule, required - … - `hideAddressField` boolean, required: Hide address field for LOCAL_ATTENDEE channel type - `form` Form - … - `availability` Availability - … - `reminders` Reminder[] - … - `locations` string[], required - `bookingFrequencies` HostBookingFrequency[]: @todo this doesn't need to be OneToMany and maybe not even a relation (unless different frequencies per user for a queue are needed) - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `connectGuestJoinMinutesBeforeStart` number, nullable: Guest may enter this many minutes before a scheduled Connect call. - `connectGuestJoinMinutesAfterEnd` number, nullable: Guest may enter until this many minutes after a scheduled Connect call. - `timeFormat` '12' | '24', required - `useHostAvailability` boolean, required - `meetingTypes` MeetingType[] - … - `id` string, required - `crmOptions` MeetingCRMOptions, required - … - `ics` IcsInfo, required - … - `daysIntoFuture` DaysIntoFutureSetting, required - … - `enableCalendarInviteNotification` boolean, required: New notification setting - use calendar invites instead of email notifications. When this option is enabled, booking confirmation notification and cancellation notification are handled by calendar connection. A google/outlook connection is required. It will be used to create calendar invite with notification. All meeting types pre-migration use email notifications. Introduced in order to mitigate duplicate invites, cancellation handling in calendar and overall improve both host and attendee experience. - `useSchedule` boolean, required: Override individual host's availability If true, availability selected for that meeting type will be used as common availability for all hosts. Move to meetingOptions? - `useCompanyLogo` boolean, required: Move to meetingOptions? - `useTeamLogo` boolean, required: Show team logo instead of company logo (for queue/round-robin meeting types) - `useCustomInvite` boolean, required: Move to meetingOptions? - `disableActionButtons` boolean, required: Move to meetingOptions? - `showConfetti` boolean, required: Whether to show confetti animation on the confirmation page - `enableWithdrawalButton` boolean, required: Show the EU/German withdrawal button on the booking confirmation page (§ 356a BGB, from 19.06.2026) - `useCustomForm` boolean, required - `formId` string - `inCompanyPage` boolean, required - `formFirst` boolean, required: Move to meetingOptions? - `communicationSettings` CommunicationSettings - … - `communicationSettingsId` number, nullable, required - `availabilityId` string - `companyId` string, required: Not null - `reminderIds` string[], required - `createdBy` User - … - `createdById` string, required - `compact` boolean, required - `disableTeamsEmail` boolean, required: If enabled, booking confirmation email won't be sent for Microsoft Teams meeting - `calendarGuestListVisible` boolean, required: Whether guests on the synced calendar event can see each other. Off by default so strangers on a group booking never see each other's address; on for teams that invite colleagues and known contacts who expect a normal shared invite. Only Google honours it; Outlook has no such flag. - `enableWaitlist` boolean, required - `runAsWebinar` boolean, required: Run bookings of this meeting type as a Connect webinar. Stamped onto members' meeting types like every other shared setting — a setting that lived only on MeetingType would silently drop when a template is applied. - `webinarDefaults` WebinarSettings, required - … - `notetakerRecording` 'on' | 'off', nullable, required: Whether the notetaker joins bookings of members' meeting types. Null lets each host's own default decide. Stamped like every other shared setting. - `languageSetting` LanguageSetting, required - … - `customTextSelectChannel` CustomTextSelectChannelSetting, required - … - `timezonePreset` TimezonePresetSetting, required - … - `cssSetting` CssSetting, required - … - `meetingPaymentInfo` MeetingPaymentInfo, required - … - `videoSetting` VideoSetting, required - … - `cancellationPolicy` CancellationPolicySetting, required - … - `reschedulingPolicy` ReschedulingPolicySetting, required - … - `recurringSetting` RecurringSetting, required - … - `templateType` 'individual' | 'team', required - `queueType` 'simpleRoundRobin' | 'advancedRoundRobin' | 'equalDistribution', nullable - `assignedToCount` number: number of meetings assigned to this template - `lockedFields` string[], required: Field keys locked by the admin. Users cannot modify the corresponding settings on meeting types created from this template. Copied to meeting types on assign and push. - `slug` string, nullable: Optional canonical URL slug. When set, this is the source of truth for the URL of meeting types created from (or synced from) this template: - Used as the base slug on `assignHost` / `assignWorkspace`. - Propagated to assigned meeting types on push. When NULL, slugs behave exactly as before: derived from the template name on assign, never touched on push. Per-user uniqueness still applies via `getAvailableMeetingTypeSlug`. - `resourceChannels` ResourceChannel[] - … - `appointments` Appointment[] - `start` string, required - `end` string, required - `isCancelled` boolean, required: Determines whether appointment was cancelled - `spots` string, nullable: Per-appointment capacity for group bookings. Copied from meetingType.spots at creation time. Can be reduced to limit new bookees without cancelling existing attendees. When null, falls back to meetingType.spots. TODO: Ideally spots should be part of MeetingInfo (alongside groupBooking) so it gets copied naturally via the meetingInfo spread. Kept as top-level for now to avoid refactoring the existing meetingType.spots column + V4 API DTOs. - `rescheduledAt` string, date-time: Timestamp when appointment was rescheduled. Null if appointment is not rescheduled. - `rescheduledBy` string, nullable: Email address of the attendee, host, or operator who last rescheduled it. - `rescheduleCount` number, required: Number of times this appointment has been rescheduled. Used as the ICS SEQUENCE number so calendar clients recognize updates. - `bookedByUserId` string, nullable - `emailDeliveryIssues` object[], nullable: Mails the provider could not deliver for this appointment, one entry per address and kind. Written from AhaSend bounce webhooks so a typo in the attendee's address is visible before the appointment is missed. - … - `location` string - `scheduledReminders` ScheduledReminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `couponCode` string: Coupon code applied to this booking's payment (null if no coupon used) - `couponDiscountAmount` number: Discount amount applied via coupon (in the payment currency) - `note` string - `transcription` string, nullable: Full meeting transcription in markdown format - `summary` string, nullable: AI-generated summary of the meeting in markdown format - `actualStartAt` string, date-time, nullable: When the conversation actually ran, as whatever was in the call witnessed it: the first captured word for a recording, the first person in the room for a Connect call. `start` and `end` say when the meeting was booked for; these say what happened. Null until something that was there reports, and permanently null for a call nothing attended. - `actualEndAt` string, date-time, nullable - `attendanceCheckedAt` string, date-time, nullable: When something that could have witnessed the call finished looking. What tells "nobody came" apart from "nothing was watching": a past booking with this set and no `actualStartAt` is one a notetaker or the Connect room waited for and nobody joined, which the dashboard offers as a no-show to confirm. Never marks the no-show itself — that reaches the contact and their automations, and stays a person's decision. - `miraBrief` string, nullable: Mira's pre-meeting brief: who is coming, what was discussed last time, what is open. Written once on first request and kept, so opening the booking twice does not pay for the model twice. - `miraBriefAt` string, date-time, nullable - `occurrenceNumber` number, nullable: Position of this appointment within the recurring series (1-based). Null for non-recurring appointments. - `isBundleBooking` boolean, required - `id` string, required - `secret` string, required - `ics` string, required - `meetingInfo` MeetingInfo, required - … - `hostingInfo` HostingInfo, required - … - `cancel` BookingActionInfo, required - … - `crmOptions` MeetingCRMOptions, required - … - `bookedBy` User - … - `utmSource` string, nullable - `utmMedium` string, nullable - `utmCampaign` string, nullable - `utmContent` string, nullable - `utmTerm` string, nullable - `referrerUrl` string, nullable - `sourceChannel` object, nullable - `formRecipientId` string, nullable: `FormRecipient.id` when a personal form link routed this booking. Without it nothing connects an appointment to the person a printed link was minted for, so a returning recipient could only be offered a second calendar. With it they are shown the booking they already hold. Plain uuid, no FK: an appointment is a real commitment and must survive the deletion of the form that routed it. - `attendees` Attendee[]: `cascade: true` exists to INSERT attendees together with a new appointment. Never `save()` an EXISTING appointment with a loaded `attendees` array: the cascade diffs against a stale snapshot and orphan-nullifies attendees linked concurrently (group-booking joins). Link/unlink attendee rows individually instead. - … - `attendeeIds` string[], required - `roundRobinEntries` RoundRobinEntry[] - … - `meetingType` MeetingType - … - `meetingTypeId` string, required: @todo should not be nullable, but prod has some null values also recently - `bookingBlockId` string, nullable, required: The booking block this appointment was booked into, set only when the invitee arrived through that block's customer link. It is the sole answer to "which bookings are in this reserved day", and deleting the day cancels exactly these. Matching on host and time instead would sweep in ordinary meetings that merely overlap. Deliberately no foreign key: the row must outlive the block it names. - `hostIds` string[], required - `companyId` string, required - `resolvableErrors` AppointmentResolvableError[] - … - `bufferReservations` BufferReservation[] - … - `paymentId` string - `recapSharedAt` string, date-time, nullable: When the host turned this meeting's recap into a shareable link, or null while it is private. A timestamp rather than a boolean because "when did we start sharing this" is the question asked after a recap turns up somewhere unexpected. Sharing is off until the host asks for it: a transcript is the most sensitive thing the product stores, and a link that exists by default is a link that leaks by default. - `notetakerNoticeEmailedAt` string, date-time, nullable: When the invitees were told by email that this meeting will be recorded. Stamped by the confirmation email when its footer carried the recording disclosure, and otherwise by the advance-notice sweep when it sends the dedicated notice 24 hours ahead. One column, two writers, one rule: a null here on a meeting that will be recorded is a notice still owed. - `preCallBriefWarmedAt` string, date-time, nullable: When the structured Connect brief was generated ahead of the call. Bookkeeping for the warming sweep, not a third brief: the text itself lives in the cache the in-call panel already reads, and this is only how the sweep knows it has done a booking. Null means the panel would still pay for the model on first open, which is the wait this removes. - `recurringSeries` RecurringSeries - … - `recurringSeriesId` string, nullable - `bundle` MeetingTypeBundle - … - `bundleId` string, nullable - `bundleItems` AppointmentBundleItem[]: Bundle items for this appointment (details of each meeting type in the bundle). Only populated for bundle bookings. - … - `emailTemplates` EmailTemplate[] - `category` 'bookingConfirmed' | 'bookingCanceled' | 'bookingRescheduled' | 'other', required - `content` EmailTemplateContent[], required - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, date-time, nullable - `reminderChannel` 'email' | 'sms' | 'whatsapp', required: Channel that the message is intended for. There are different requirements for each channel. For example, "sms" has a shorter character limit. - `id` string, required - `name` string, required - `reminderActions` ReminderAction[] - … - `permament` boolean, required - `companyId` string - `workspaces` Workspace[] - `connectWaitingRoom` ConnectWaitingRoomSettings - … - `integrationPermissions` object: Workspace-level integration permission overrides. Can override company settings (allow or deny specific integrations). - `customBookingCSS` string: Custom CSS for booking and confirmation pages. When set, this overrides the company-level customBookingCSS for this workspace's meeting types. Applied to both booking pages and confirmation/reschedule/cancel pages. - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` string, required - `name` string, required - `slug` string, required: Slug must be unique - `picture` string: Full url to workspace picture hosted statically - `description` string - `primaryColor` string - `logoUrl` string - `language` 'en' | 'de' | 'fr' | 'es' | 'no' | 'nl' | 'it' | 'pl' | 'se' | 'tr' | 'da' - `salesforceStudioId` string: Salesforce Studio__c Record ID Used for Küche&Co integration to link Cases to Studios - `useCompanyDefaultColor` boolean, required - `useCompanyDefaultLanguage` boolean, required - `useCompanyDefaultLogo` boolean, required - `useCompanyDefaultContactInfo` boolean, required - `showTeamSection` boolean, required - `showServicesSection` boolean, required - `showCompanyDetails` boolean, required - `showContactInfo` boolean, required - `emailAddress` string - `phone` string - `website` string - `address` string - `privacyUrl` string - `imprintUrl` string - `emailSenderName` string: Email sender name. Only name part of sender string without email. - `emailSenderAddress` string: Email sender address. Only email part of sender string. Only active if custom smtp is active. Otherwise this is ignored. - `enableCustomLegalText` 'Enable' | 'Disable' | 'Inherit', required: Enable/disable custom legal text - `customLegalText` string: Custom legal text HTML, shown above booking button if enabled - `reviewSettings` WorkspaceReviewSettings - … - `company` Company (recursive) - `companyId` string, required - `users` User[] - … - `adminUsers` User[] - … - `analyticsViewers` User[]: Analytics-only viewers of this team. They can see this workspace's analytics (scoped to its members) but get no admin or edit rights — deliberately separate from `adminUsers`, which the meeting-type edit gates key off. Used for the "analytics for employees" role. - … - `meetingTypes` MeetingType[] - … - `queues` Queue[] - … - `reminders` Reminder[] - … - `forms` Form[] - … - `queues` Queue[] - `type` 'simpleRoundRobin' | 'advancedRoundRobin' | 'equalDistribution', required - `roundRobinEntries` RoundRobinEntry[], required - … - `meetingType` MeetingType - … - `qualifiers` Qualifier[], nullable - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` string, required - `workspace` Workspace - … - `workspaceId` string - `oldMeetingType` MeetingType - … - `meetingTypeId` string, required: Currently, there are several fields with value null in prod. I'm not sure if that does anything. I suspect that all rows with null meeting type id are orphaned. @todo confirm theory and migrate to non nullable - `userCapacities` UserCapacity[], required - … - `userPriorities` UserPriority[], required - … - `userCustomLinks` UserCustomLink[], required: Per-host overrides resolved by `CalendarLinkService.addMeetingLink` (CUSTOM channel). - … - `maxLeadThreshold` number, required: Maximum number of bookings a host can be ahead of the least-booked host before their availability is hidden. Ensures fair distribution. - `distributionPeriod` object, required: Period over which bookings are counted for equal distribution. Counts reset at the start of each period. - `prioritizeNearTermAvailability` boolean, required: When true, if fairness filtering (maxLeadThreshold) would push the next available slot more than 14 days beyond the meeting type's minimum booking notice, temporarily include over-lead hosts so bookers aren't penalized by fairness enforcement. Disable only if strict fairness must never yield to booker-visible availability. - `userGroups` QueueUserGroup[], required - … - `userGroupIds` string[], required - `companyId` string, required: Not null - `users` User[] - … - `userIds` string[], required - `dataFields` DataField[] - `id` number, required - `label` string, required - `name` string, required - `target` 'email' | 'firstname' | 'lastname' | 'fullname' | 'phone' | 'marketing_consent' | 'other', required - `fieldType` 'email' | 'phone' | 'text-single' | 'text-multi' | 'number' | 'select' | 'checkbox-single' | 'checkbox-multi' | 'radio' | 'slide' | 'url' | 'file' | 'date-of-birth' | 'yes-no' | 'rating' | 'scale' | 'signature' | 'date' | 'time' | 'image' | 'heading' | 'separator' | 'page-break' | 'contact' | 'bank-details' | 'license-plate' | 'info-text' | 'info-image' | 'info-video' | 'currency' | 'location' | 'pdf-template' | 'file-download' | 'testimonial' | 'faq' | 'countdown' | 'loading' | 'quiz-reveal' | 'logos' | 'checklist' | 'html' | 'address', required - `order` number, required: Where this field sits when its values are read back on a record. A contact's custom fields are a jsonb bag keyed by field name, so the card showing them had no order but the one values happened to be written in — which put a postcode above the street it belongs under. Ordering the definitions gives every surface reading `additionalData` one answer. Lower first; ties fall back to id, so untouched companies keep the order they already see. - `locales` FieldLocale[], required - … - `default` boolean, required - `required` boolean, required - `hidden` boolean, required - `hideUntilChange` boolean, required - `mutable` boolean, required - `defaultValue` string - `placeholder` string - `options` FieldOptions[], required - … - `slideOptions` SlideOptions - … - `fileFieldOptions` FileFieldOptions - … - `contactOptions` ContactOptions - … - `hubspotContactField` string - `hubspotCompanyField` string - `smartWeContactField` string - `smartWeCompanyField` string - `pipedriveContactField` string - `closeContactField` string - `salesforceContactField` string - `salesforceLeadField` string - `salesforceCaseField` string - `salesforceOpportunityField` string - `salesforceAccountField` string - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `helpText` string: Optional help text shown below the field in the booking form. Provides additional guidance to users filling out the form. - `bankDetailsOptions` BankDetailsOptions - … - `licensePlateOptions` LicensePlateOptions - … - `textFormatOptions` TextFormatOptions - … - `pdfTemplateOptions` PdfTemplateOptions - … - `fileDownloadOptions` FileDownloadOptions - … - `blockOptions` BlockOptions - … - `displayStyle` object: Controls how options are displayed for radio/checkbox/select fields. 'default' - Standard list view 'card' - Card grid with optional icons - `conditions` object, nullable: Conditional visibility expression. When set, the field is only shown to the visitor when the expression evaluates to true against current form values. Uses the same Expression/ExpressionCondition structure as routing rules. - `headingLevel` number: Heading level for heading fields (1–6). Defaults to 2 (renders as

). - `signingPaused` boolean: Computed per request when a public form is served — not persisted. Populated by `PublicFormController.withSigningAvailability`. True when the owning company has used this month's signature allowance, so the renderer shows this field as temporarily unable to take a signature instead of a signature pad. The rest of the form still renders and still submits: these forms are lead capture, and losing the lead would cost the owner far more than the unsigned document. - `showInfobox` boolean, required: Only for data fields of type slide, enable to show an infobox. - `infoboxText` string: Only for data fields of type slide, custom infobox text. - `companyId` string, required - `evalancheFieldId` string - `klicktippFieldId` string - `min` number: Currently used by number field as min value. For string field, it is minimum amount of characters. - `max` number - `style` number: For Phone Number field - used to set the style of phone input. 0 - Simple (Default) 1 - With country code picker - `defaultCountryCode` string: For Phone Number field - default country code (e.g., "+1", "+49", "+44"). Used when style is WITH_COUNTRY_CODE_PICKER to set the initial country selection. - `useMarkdown` boolean, required: When true, field.label is rendered through markdown-it (html: false). Allows **bold**, _italic_, `code`, and links in field labels. - `requireSignatureOtp` boolean, required: When true, the signer must verify their email via OTP before the signature canvas is unlocked. - `emailTemplateSelection` EmailTemplateSelection - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` string, required - `companyId` string - `attendeeMeetingConfirmation` EmailTemplate - … - `attendeeMeetingConfirmationId` string - `hostMeetingConfirmation` EmailTemplate - … - `hostMeetingConfirmationId` string - `attendeeMeetingCancelled` EmailTemplate - … - `attendeeMeetingCancelledId` string - `hostMeetingCancelled` EmailTemplate - … - `hostMeetingCancelledId` string - `attendeeMeetingRescheduled` EmailTemplate - … - `attendeeMeetingRescheduledId` string - `hostMeetingRescheduled` EmailTemplate - … - `hostMeetingRescheduledId` string - `bringalongMeetingConfirmation` EmailTemplate - … - `bringalongMeetingConfirmationId` string - `hostMeetingReassigned` EmailTemplate - … - `hostMeetingReassignedId` string - `attendeeMeetingHostChanged` EmailTemplate - … - `attendeeMeetingHostChangedId` string - `attendeeMeetingCancelRequest` EmailTemplate - … - `attendeeMeetingCancelRequestId` string - `attendeeMeetingRescheduleRequest` EmailTemplate - … - `attendeeMeetingRescheduleRequestId` string - `doubleOptInRequest` EmailTemplate - … - `doubleOptInRequestId` string - `requireHostConfirmation` EmailTemplate - … - `requireHostConfirmationId` string - `reviewRequestTemplate` EmailTemplate - … - `reviewRequestTemplateId` string - `waitlistNotification` EmailTemplate - … - `waitlistNotificationId` string - `invites` CompanyInvite[] - `secret` string, required - `companyId` string, required - `company` Company (recursive) - `expiry` string, date-time, required - `email` string, nullable, required - `inviteType` 'standard' | 'resource' | 'api-platform' | 'partner' | 'viewer', required: The type of user this invite will create. 'standard' for regular team members, 'partner' for partner users. - `partnerPermissions` object, nullable: Permissions to apply when a partner invite is accepted. Null for non-partner invites. - `meta` DateMeta, required - … - `hubspotConnection` HubspotConnection - `companyId` string, required - `refreshToken` string, required - `accessToken` string, required - `accessTokenExpiration` string, required - `synchronizedFields` boolean, required: Used for existing users to create custom properties on booking - `pipedriveConnection` PipedriveConnection - `companyId` string, required - `refreshToken` string, required - `accessToken` string, required - `accessTokenExpiration` string, required - `apiDomain` string, required - `scopes` string[], required - `synchronizedFields` boolean, required: Used for existing users to create custom properties on booking - `closeConnection` CloseConnection - `companyId` string, required - `refreshToken` string, required - `accessToken` string, required - `accessTokenExpiration` string, required - `apiDomain` string, required: Close has no per-tenant API domain like Pipedrive — every request goes to api.close.com. Persisted for symmetry with other CRM connections. - `scopes` string[], required - `synchronizedFields` boolean, required: Set after custom fields are auto-created on first connect. - `centralStationCrmConnection` CentralStationCrmConnection - `companyId` string, required - `refreshToken` string, nullable, required: Refresh token. 42he issues rotating refresh tokens on every refresh exchange — each one is single-use, with a 3-month idle expiry (after which the user must reconnect). The column is nullable to accommodate legacy connections created before refresh tokens were enabled (2026-04); those rows will hit the "please reconnect" path on first refresh and pick up a refresh token from there. - `accessToken` string, required - `accessTokenExpiration` string, nullable, required: ISO timestamp at which `accessToken` expires. Currently ~2 hours from issue per 42he's config, but we always read `expires_in` from the token response rather than hard-coding. `null` only for legacy rows created before expiry was tracked. We pre-empt expiry by 60 seconds to avoid tight-edge races on long-running booking flows. - `scopes` string[], required - `ameiseConnection` AmeiseConnection - `companyId` string, required - `tenant` string, required - `baseUrl` string, required - `tenantName` string - `tokenName` string - `tokenExpiresAt` string, date-time, nullable - `abAgentaConnection` AbAgentaConnection - `companyId` string, required - `baseUrl` string, required - `customerObjectTypeId` string, required - `fieldMapping` object, required - `noteMapping` object, nullable - `syncCrmNotesAndDocuments` boolean, required - `lastValidatedAt` string, date-time, nullable - `salesforceConnection` SalesforceConnection - `utmFieldMappings` object: UTM parameter to Salesforce field mappings - `isSandbox` boolean, required: Whether this connection uses a Salesforce Sandbox org - `autoConnectUserCalendars` boolean, required: Automatically connect members' Salesforce calendars when their email matches - `companyId` string, required - `id` string, required - `refreshToken` string, required - `accessToken` string, required - `signature` string, required - `instanceUrl` string, required - `scopes` string[], required - `issuedAt` string, required - `slackConnection` SlackConnection - `companyId` string, required - `teamId` string, required - `teamName` string, required - `botUserId` string, required - `channelMappings` object, required: Mapping of meeting type IDs to channel IDs Format: { "meetingTypeId": { channelId: "C123", channelName: "sales" }, ... } Empty object means no notifications - `enabledEvents` string[], required: Which booking events trigger notifications - `createdAt` string, date-time, required - `intercomMessengerConnection` IntercomMessengerConnection - `companyId` string, required - `workspaceId` string, required: Intercom workspace identifier (`app.id_code`). Surfaced in the settings UI so admins can verify they connected the right workspace. Unique because a single Intercom workspace is the authoritative source for canvas requests — if two meetergo Companies both connected the same workspace, every Canvas Kit request would resolve to a non-deterministic Company. Re-installing from the same workspace deletes the prior connection in `IntercomMessengerAuthService.connect`. - `workspaceName` string, nullable - `region` object, required: Hosting region — Intercom serves EU and AU workspaces from separate API hostnames (`api.eu.intercom.io`, `api.au.intercom.io`). Defaults to "us" when Intercom does not report a region. `varchar(8)` leaves headroom for future regional shards Intercom might add (e.g. `latam`) without a column-resize migration. - `installedByAdminId` string, nullable: Intercom admin id (the user who installed the app). Used for posting admin notes. - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `hubSubscription` HubSubscription - `companyId` string, required - `company` Company (recursive) - `stripeSubscriptionId` string, required - `stripeSubscriptionItemId` string, nullable: Stripe subscription item ID — set when this add-on is bundled as a line item on the plan subscription. Null for legacy standalone subscriptions. - `subscriptionStatus` object, required - `slotsAmount` number, required - `assignedTo` string[], required: Users that can use this subscription. Cannot exceed slotsAmount * 2 (each workspace covers 2 users). Empty means all company users have access. - `cancelAtPeriodEnd` boolean, required: True when the user has cancelled but the subscription is still in its paid period. - `currentPeriodEnd` string, date-time, nullable: The date the subscription ends (only set when cancelAtPeriodEnd is true). - `crmSubscription` CrmSubscription - `companyId` string, required - `company` Company (recursive) - `stripeSubscriptionId` string, required - `stripeSubscriptionItemId` string, nullable: Stripe subscription item ID — set when this add-on is bundled as a line item on the plan subscription. Null for legacy standalone subscriptions. - `subscriptionStatus` object, required - `slotsAmount` number, required: Number of user seats purchased for CRM - `assignedTo` string[], required: Users that can use this subscription. Cannot exceed slotsAmount. Empty means all company users have access (backward compatibility). - `cancelAtPeriodEnd` boolean, required: True when the user has cancelled but the subscription is still in its paid period. - `currentPeriodEnd` string, date-time, nullable: The date the subscription ends (only set when cancelAtPeriodEnd is true). - `whatsappSubscription` WhatsappSubscription - `companyId` string, required - `company` Company (recursive) - `stripeSubscriptionId` string, required - `stripeSubscriptionItemId` string, nullable: Stripe subscription item ID — set when this add-on is bundled as a line item on the plan subscription. Null for legacy standalone subscriptions. - `subscriptionStatus` object, required - `phoneNumbersAmount` number, required: Number of phone numbers purchased for WhatsApp. - `cancelAtPeriodEnd` boolean, required: True when the user has cancelled but the subscription is still in its paid period. - `currentPeriodEnd` string, date-time, nullable: The date the subscription ends (only set when cancelAtPeriodEnd is true). - `klickTippConnection` KlicktippConnection - `id` string, required - `company` Company, required (recursive) - `companyId` string, required - `customerKey` string, required: Klicktipp customer key - `doiFieldId` string: Klicktipp field id for double opt in process to use - `appointmentStartFieldId` string: Klicktipp field id for appointmennt start time - `meetingLocationFieldId` string: Klicktipp field id for the meeting location resolves to meeting link for online channels resolves to address for local channel otherwise resolves to channel name - `meetingTypeNameFieldId` string: Klicktipp field id for meeting type name - `meetingTypeDescriptionFieldId` string: Klicktipp field id for meeting type description - `cancellationLinkFieldId` string: Klicktipp field id for booking cancellation link - `rescheduleLinkFieldId` string: Klicktipp field id for booking reschedule link - `bookingDateFieldId` string: Klicktipp field id for booking date - `globalTagIds` string[], required: Global tag that is assigned to all contacts in klicktipp - `enableForAllMeetingTypes` boolean, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `smartWeCRMConnection` SmartWeCRMConnection - `companyId` string, required - `email` string, required - `accessToken` string, required - `refreshToken` string, required - `tokenType` string, required - `scope` string, required - `expiresAfter` number, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `stripeFeatureConnection` StripeFeatureConnection - `companyId` string, required - `refreshToken` string - `accessToken` string, required - `scope` string - `stripeUserId` string - `token_type` string - `stripePublishableKey` string - `accessTokenExpiration` string, required - `paypalFeatureConnection` PaypalFeatureConnection - `companyId` string, required - `refreshToken` string - `accessToken` string, required - `scope` string - `paypalPayerId` string, required - `tokenType` string - `nonce` string - `accessTokenExpiration` string, required - `paypalEmailAddress` string - `mollieFeatureConnection` MollieFeatureConnection - `companyId` string, required - `accessToken` string, required - `refreshToken` string - `scope` string - `mollieOrganizationId` string: Mollie organization ID (org_xxxxxx); stored for ops/debugging. - `mollieProfileId` string: Profile ID — payments are tied to a specific Mollie profile (pfl_xxxxxx). - `tokenType` string - `accessTokenExpiration` string - `webhookSecret` string, required: Per-company random secret embedded in this merchant's webhook URL (`/mollie-feature/hooks/:webhookSecret`). Anyone hitting the webhook without the secret gets a 404; Mollie itself does not sign requests so the unguessable path is the only inbound auth. The unique index lets webhook lookup hit O(1) without a full scan and guarantees no two merchants ever share the same path. - `needsReauth` boolean, required: Set when token refresh fails (revoked grant, scopes changed). `getConnection` rejects so callers surface "reconnect Mollie". - `aircallConnection` AircallConnection - `companyId` string, required - `accessToken` string, required - `tokenType` string, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `reviewSettings` ReviewSettings - `reviewCollection` boolean, required: Send a review request automatically after every meeting. Does not affect the public review page. - `pageEnabled` boolean, required: Serve the public review collection page - `autoApprove` boolean, required: Automatically approve new reviews - `showOnBooking` boolean, required: Show reviews on booking pages - `anonymousCollection` boolean, required: Allow anonymous reviews - `enableGoogleSnippet` boolean, required: Show Google reviews - `emailDelay` '1h' | '2h' | '3h' | '4h' | 'next-day' | '1d' | '2d' | '3d', required: Delay before sending review request email after meeting - `showFloatingWidget` boolean, required: Display the floating review widget on the website - `collectionLevel` 'company' | 'workspace', required: Level at which reviews are collected (company or workspace) - `googleReviewUrl` string: Google review URL where customers can leave a Google review (e.g. https://g.page/r/abc/review) - `showGoogleCta` boolean, required: Show a Google review CTA after review submission - `googleCtaMode` 'all' | 'gated', required: Google CTA mode: "all" shows to everyone, "gated" shows only to positive reviewers - `googleCtaThreshold` number, required: Minimum star rating to show Google CTA (only used when googleCtaMode is "gated") - `googlePlaceId` string: Google Place ID for importing Google reviews - `provenExpertReviewUrl` string: ProvenExpert survey/profile URL to send reviewers to after they submit (e.g. https://www.provenexpert.com//) - `showProvenExpertCta` boolean, required: Show a ProvenExpert CTA after review submission - `provenExpertSurveyCode` string: ProvenExpert survey code, used to generate a personalised invite link per reviewer - `provenExpertCtaMode` 'all' | 'gated', required: ProvenExpert CTA mode: "all" shows to everyone, "gated" shows only to positive reviewers - `provenExpertCtaThreshold` number, required: Minimum star rating to show the ProvenExpert CTA (only used when provenExpertCtaMode is "gated") - `trustpilotReviewUrl` string: Trustpilot review URL to send reviewers to after submission - `showTrustpilotCta` boolean - `trustpilotCtaMode` 'all' | 'gated' - `trustpilotCtaThreshold` number - `cituroRatingsUrl` string: Public cituro ratings profile (URL or slug, e.g. https://app.cituro.com/ratings/erzengel) used for a one-time import of the business’s own reviews when switching from cituro - `reviewChannels` string[], required: Channels to use for sending review invitations after meetings - `pageDesign` ReviewPageDesign - … - `shareSettings` ReviewShareSettings - … - `referralSettings` ReferralSettings - `enabled` boolean, required - `headline` string, required - `body` string, required - `mediaType` 'none' | 'image' | 'video', required - `mediaUrl` object, nullable, required - `tiers` ReferralTier[], required - … - `verificationNote` string, required - `termsText` string, required - `showAfterReview` boolean, required - `qualificationMode` 'auto_booking' | 'manual_confirm', required - `meetingTypeId` object, nullable - `standalonePage` boolean, required - `groups` Group[] - `id` string, required - `companyId` string, required: Relation to company with FK, cascade delete, index - `company` Company (recursive) - `name` string, required: Group name/title - `users` User[]: Non-admin users relation. A soft limit should be enforced. - … - `admins` User[]: Admins of the group. Admins should only be in this relation and not a user as well. A soft limit should be enforced. - … - `meta` DateMeta, required - … - `provisionalBookings` ProvisionalBookingPayload[] - `id` string, required: Generated ID - `dto` BookingDto, required - … - `locationSelectionContext` object, nullable, required: Trusted Finder selection retained across confirmation flows. - `type` 'doubleOptIn' | 'requireHostConfirmation', required - `company` Company, required (recursive) - `hosts` User[] - … - `meetingType` MeetingType, required - … - `Appointment` Appointment - … - `appointmentId` string - `queueBookingInfo` NextQueueHostsSelectionReasonDto - … - `createdAt` string, date-time, required - `deletedAt` string, date-time, nullable, required - `status` 'pending' | 'confirmed' | 'expired' | 'declined_by_host', required: Status of the provisional booking request - `declineReason` string: Reason provided by host when declining (optional) - `resolvedAt` string, date-time: Timestamp when the booking was declined or expired - `expiryWarningSent` boolean, required: Whether the "expiring soon" warning email has been sent to the host - `expiresAt` string, date-time: When this provisional booking expires. Set at creation time based on company's provisionalBookingExpiryHours or default 72h. - `start` string, date-time: Reserved slot start. Used by availability checks so pending payloads block the slot for other bookers until the payload is confirmed, declined, or expired. - `end` string, date-time: Reserved slot end. - `voiceTrialExpiresAt` string, date-time, nullable, required - `voiceBilling` object, required - `enabled` boolean - `packSize` object - `maxPacksPerMonth` number - `lastFailureAt` string, nullable - `lastAttemptAt` string - `pendingTopUp` object, required - … - `alertPeriod` string - `alerted80` boolean - `alerted100` boolean - `commissionPercentage` number, required: Affiliate commission percentage for the company's referral/partner user program. This is about *partner users* inside a Company and the Cello affiliate program — NOT the `Reseller` entity's commission (which lives on `Reseller.commissionPercentage`). - `resellerId` string, nullable: Reseller that provisioned this Company (e.g. Placetel). Nullable: Companies registered through the regular signup flow have no reseller. Replaces the legacy `metadata.partner` string marker. Set during provisioning via the unified `signUpNewAdmin` flow. Used by the reseller dashboard to scope its queries to the reseller's own companies. - `reseller` Reseller - `id` string, required - `slug` string, required: Human-readable stable identifier used in the provisioning API and as `metadata.partner` string on legacy Companies. Lowercase, URL-safe. Example: 'placetel'. - `name` string, required - `provisioningSecretHash` string, required: Bcrypt hash of the provisioning secret. Compared in constant-time in ResellerAuthGuard. Rotate by regenerating the hash and updating this field; the reseller updates their secret on their end. - `dashboardPasswordHash` string, nullable: Bcrypt hash of the dashboard login password. Separate from the provisioning secret so the two can be rotated independently. - `billingModel` 'external' | 'internal', required - `defaultTier` 'basic' | 'essentials' | 'growth' | 'teams' | 'light' | 'suite' | 'premium' | 'enterprise', nullable: Tier granted to newly provisioned companies when billingModel=EXTERNAL. Ignored when billingModel=INTERNAL (company gets a trial like normal). - `autoVerifyEmail` boolean, required: Auto-confirm Cognito user + mark email verified on provisioning. - `issuePatOnProvision` boolean, required: Generate a PAT and return it in the provisioning response. - `commissionPercentage` number, required: Commission percentage retained by the reseller when billingModel=INTERNAL. Unused for EXTERNAL resellers (they keep 100% of end-user revenue). - `pricePerSeatEur` string, nullable - `currency` string, required: ISO 4217 currency for billing. - `testEmailDomains` string[], required: Email domains whose accounts are test/internal and excluded from billing (contract §6 for Placetel). Matched as `%@`. Empty = bill everything. Single source of truth for the billing extract. - `billingStartDate` string, date-time, nullable: First day billing accrues from (go-live). Used for the arrears schedule. Null until the reseller goes live. - `billingSeatBasis` object, required: Defines which contractual population the reseller billing extract counts. Legacy resellers keep the account-activity basis; partner-program resellers use the same live licensed-user population as Stripe seats. - `sevdeskCustomerId` string, nullable: sevDesk customer id this reseller's invoices are raised against. - `defaultAllowPhoneOnlyBooking` boolean, required - `defaultChannel` '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', nullable - `defaultAutoEnableSmsConfirmation` boolean, required: When true, the default meeting type seeds an SMS confirmation workflow out of the box. Requires the reseller to fund SMS credits (smsCreditsPerAccount > 0 + a live pool) for it to actually send. - `smsCreditsPerAccount` number, required - `active` boolean, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `emailFromName` string: Value to use as from email name. If not defined, company name should be used. - `footerEmail` string, nullable, required: Contact shown in the email footer. Without these the footer falls back to the company OWNER's personal contact email/phone, which leaks a person where a role address belongs (JoFinanz, 2026-08-24). Precedence in the renderer: workspace override → these → owner. Null = today's behavior. - `footerPhone` string, nullable, required - `permissions` PermissionSettings, required - `meetingTypeCreate` string, required - `workflows` string, required - `forms` string, required - `inviteNewUsers` string, required - `handoffTarget` string, required - `filterAccess` string, required - `contactsVisibiltyPermission` string, required - `crmDelete` string, required - `aiPhoneAssistant` string, required - `excludeAdminsFromTeamAnalytics` boolean, required - `slugChange` string, required - `doubleOptIn` boolean, required: Double opt in feature, default disabled. - `enableCustomLegalText` boolean, required: Enable/disable custom legal text - `customLegalText` string: Custom legal text HTML, shown above booking button if enabled - `requireInvite` boolean, required - `flag` number: Used to flag suspicious accounts or ban. Smallint is used as to not expose any descriptive value. Currently, only two values are used. `null` = Account is not flagged `1` = Banned. Account is banned from doing anything. - `registrationIp` string, nullable - `signupChannel` string, nullable: Lead-source attribution captured on the marketing site (first touch on meetergo.com) and handed over at signup via the `mg_attribution` cookie. Written once by POST /me/signup-complete for the admin who created the company; never overwritten. Channel is the classified bucket (paid_search | organic_search | ai_assistant | social | referral | …). - `signupChannelSource` string, nullable: Normalized source of the first touch, e.g. "google", "chatgpt", "linkedin". - `signupSource` string, nullable: Legacy signup-source bucket (utm_source_medium or referrer-derived). - `signupReferrer` string, nullable: External referrer hostname of the first marketing-site touch. - `signupLandingPage` string, nullable: Landing page path of the first marketing-site touch. - `signupSourceUrl` string, nullable: Page the signup click happened on (source_url param). - `signupUtmSource` string, nullable - `signupUtmMedium` string, nullable - `signupUtmCampaign` string, nullable - `signupUtmTerm` string, nullable - `signupUtmContent` string, nullable - `signupFirstTouchAt` string, date-time, nullable: When the lead first touched the marketing site. - `finishedOnboarding` boolean, required: Determines whether company has completed onboarding - `requireHostConfirmation` boolean, required: Require host confirmation feature, default disabled. When enabled, hosts need to confirm before the appointment is created. - `provisionalBookingExpiryHours` number: Expiry time for provisional bookings in hours. If null, uses the default of 72 hours. - `enableNextBooking` boolean, required - `enableCookieBanner` boolean, required - `useDedicatedIP` boolean, required: Enable dedicated IP support for Exchange connections. When true, Exchange traffic will be routed through a proxy to ensure all requests come from a single determined IP. @todo store the actual proxy credentials to be able to support different proxies per client. - `useCustomSmtpDedicatedIP` boolean, required: Enable dedicated IP support for Custom SMTP connections. When true, Custom SMTP traffic will be routed through a proxy to ensure all emails originate from the configured dedicated IP. This applies to all SMTP configurations for this company. Proxy is used during both verification and email sending. - `sallyEnabled` boolean, required: When enabled, invite@sally.io is automatically added to online meetings as an attendee for AI meeting transcription. - `defaultDomainEntity` CustomDomain - `domain` string, required - `createdBy` User, required - … - `createdById` string, required - `status` 'pending' | 'verified' | 'active', required - `acmValidationCnameName` string, nullable, required: ACM DNS-validation record (cloudfront rows only). Bunny proves control through the routing CNAME itself, so these are null there. - `acmValidationCnameValue` string, nullable, required - `acmValidationCnameTTL` number, required - `routingCnameName` string, required - `routingCnameValue` string, required - `routingCnameTTL` number, required - `company` Company, required (recursive) - `companyId` string, required - `usercentricsSettingsId` string, nullable, required: Per-domain override of the company's Usercentrics Settings-ID. Only takes effect while the company has `featureAccess.cmpIntegration`, same as the company-level field. See design spec 2.1. - `gtmContainerId` string, nullable, required: Per-domain override of the company's GTM Container ID. See design spec 2.1. - `gtmServerContainerUrl` string, nullable, required: Per-domain override of the company's server-side GTM loader URL. See design spec 2.1. - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `certificateArn` string, nullable, required - `edgeProvider` object, required - `bunnyPullZoneId` number, nullable, required: Bunny pull zone the hostname lives on (bunny rows once the CNAME was seen). Hostnames are spread over several zones, 100 per zone cap. - `verificationError` string, nullable, required: Why verification cannot proceed even though the customer did their part, e.g. `caa-blocks-letsencrypt`. Shown in the dashboard; null when clear. - `cloudfrontDistroId` string, nullable, required - `cdnEtag` string, nullable, required: ETag of the CloudFront distribution needed for deleting it. - `cdnEndpoint` string, nullable, required: URL of the CloudFront distribution - `defaultDomain` string - `jitsiCustomDomain` string, nullable: Custom domain for Jitsi Meet video conferencing (e.g., 'meet.example.com') When set, Jitsi rooms will use this domain instead of the default meet.jit.si Format: https://{customDomain}/{roomId} - `lowStorageNotifiedAt` string, date-time, nullable: When low storage notification was last sent (null = not sent). Used to prevent duplicate notifications. - `crmSettings` object, nullable: Per-company CRM configuration that is too small to deserve its own table: today the lost-reason list and whether one is mandatory. Unset means "never configured" and resolves to the built-in reasons, so every existing account keeps the list it already had. - `meetingType` MeetingType - `meetingInfo` MeetingInfo, required - `name` string, required: Name of the meeting type - `description` string, required: Description of the meeting type - `nameLocalised` LocalisedContent - … - `descriptionLocalised` LocalisedContent - … - `enableRedirect` boolean, required: Enable redirect after booking completion - `redirect` string, required: Redirect URL to navigate after booking - `passEventDetailsToRedirect` boolean, required: Pass event details (invitee name, email, form answers) as query params to redirect URL - `duration` number, required: Primary duration in minutes - `channel` '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', required: Meeting channel/location type - `customChannelName` string, required: Custom name for the meeting channel - `customChannelLink` string, required: Custom link for the meeting channel - `connectChannelName` string, required: Custom display name for the connect channel - `groupBooking` boolean, required: Enable group booking (multiple attendees per slot) - `showAvailableSlots` boolean, required: Show available spots count on the booking page - `enrichInvitee` boolean, required: Enable invitee data enrichment - `autoCreateSpace` boolean, required: Auto-create a Space when someone books - `spacePresetId` object, nullable: Space preset id used for the auto-created Space - `spaceAutoInvite` boolean, required: Publish the auto-created Space and invite the booker - `confirmationButton` ConfirmationButton, required - … - `bufferBefore` number, required: Buffer time before meeting in minutes - `bufferAfter` number, required: Buffer time after meeting in minutes - `bufferMustStayWithinWorkingHours` boolean, required: Only offer slots where buffer fits within working hours (no spillover into breaks or after-hours) - `rollingSlots` boolean, required: Restart the slot grid after each appointment instead of keeping a fixed grid per working block - `color` object, nullable: Color for the meeting type in RGB format, e.g. "rgb(0, 153, 255)" - `meetingOptions` MeetingOptions, required - `allowedDurations` number[], required: Additional duration options in minutes (shown alongside primary duration) - `allowSelectChannel` boolean, required: Allow attendees to select meeting channel/location - `allowHostSelection` boolean, required: Allow attendees to select specific host (round-robin only) - `forceHostSelection` boolean, required: Force host selection (no "any host" option available) - `allowedChannels` MeetingTypeChannel[], required: Available channel options when allowSelectChannel is enabled - `channelAvailabilities` object: 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` boolean, required: Allow attendees to invite additional guests - `doubleOptIn` string, required: Double opt-in confirmation setting - `requireHostConfirmation` string, required: Require host confirmation for bookings - `enableClusterMeeting` boolean, required: Show only time slots adjacent to existing meetings - `enableBufferCarryOver` boolean, required: Carry over buffer time to next available slot if needed - `maxBufferCarryOverDelay` number, required: Maximum hours for buffer carry-over delay (0-168) - `allowPhoneOnlyBooking` boolean, required: Allow phone-only bookings without email (API use case, requires phoneOnlyBooking in request) - `hideReassignedHostDetails` boolean, required: Hide the previous host's details from attendee reassignment emails - `confirmationPageCssSetting` CssSetting, required - … - `bookingPagePassword` BookingPagePasswordSetting, required - … - `timeslotInterval` number, required - `spots` number, required - `enabled` boolean, required - `isHidden` boolean, required: Marks meeting types that should be hidden from user-facing UIs. Used for system-generated meeting types (e.g., calgent auto-bookings). When true: - Not shown in meeting type lists (filtered in all queries) - Cannot be directly edited by users via UI - May be managed by automated processes - `slug` string, required - `bookingMinimum` number, required: Time in minutes. Default 30 mins - `roundRobin` string[], required: Used to store user latest booked host ids Last element - lastest booked host There shouldn't be duplicates - `schedule` WeeklySchedule, required - `monday` DaySchedule, required - … - `tuesday` DaySchedule, required - … - `wednesday` DaySchedule, required - … - `thursday` DaySchedule, required - … - `friday` DaySchedule, required - … - `saturday` DaySchedule, required - … - `sunday` DaySchedule, required - … - `hideAddressField` boolean, required: Hide address field for LOCAL_ATTENDEE channel type - `form` Form - `id` string, required - `name` string, required - `title` object, required: Title to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `actionButtonText` object, required: Button text to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `blockedEmails` string[], required - `fields` FormField[], required - … - `funnelSteps` FunnelStep[], required - … - `default` boolean, required: Indicates default form that can be modified, but should not be deleted - `funnelConditions` FunnelQualifier[], required - … - `useFullName` boolean, required - `skipForm` boolean, required - `showProgressBar` boolean - `useMeetingTypeSelection` boolean, required - `selectMeetingTypes` MeetingType[], required - `selectMeetingTypeOrder` string[]: Stores the order of meeting types for selection pages. If empty/null, use default order from selectMeetingTypeIds. - `selectionPageLayout` 'grid' | 'list' | 'cards' | 'tiles' | 'spotlight' | 'minimal' | 'showcase', required - `selectionPageDescription` object, required: Intro text shown under the selection page title, per language code. - `selectionPageSocialLinks` object, required: Social and contact links shown on the selection page. - `meetingType` MeetingType (recursive) - `meetingTypeTemplate` MeetingTypeTemplate - … - `standaloneKind` 'routing' | 'selection' | 'locationFinder': Explicit discriminator for standalone public experiences. Null preserves the legacy relation-based classification during the mixed-version rollout. - `qualifiers` Qualifier[] - … - `workspace` Workspace - … - `formTheme` FormTheme - … - `structureType` 'FORM_ONLY' | 'FUNNEL_WITH_FORM' | 'FUNNEL_ONLY', required: slug used in routing form only. - `sendRoutingFormSubmissionNotification` boolean, required - `notificationUserId` string, nullable - `notificationEmail` string, nullable - `contactTags` string[], required: Tags written onto the contact a submission creates or updates. Additive: a submission never removes a tag. This is where a newsletter audience grows by itself, and where a sequence trigger gets its tag from (`functions/contact-tags.ts`, configured in the Newsletter app). - `marketingConsentDoubleOptIn` boolean, required: Whether a ticked marketing-consent field is only recorded after the contact confirms it from their inbox. Off: the tick itself is the consent. On: the submission sends a confirmation mail and the ledger row is written when its link is used (`FormMarketingConsentService`). - `redirectAfterSubmission` boolean, required - `redirectUrl` string, nullable - `allowSaveAndReturn` boolean, required - `prefillLock` PrefillLock - … - `salesforceAccountMatch` SalesforceAccountMatch - … - `showCompanyLogo` boolean, required - `webhookUrl` string, nullable - `cssWorkspaceId` string, nullable: Which workspace's CSS to use when cssSetting.mode is Company. If null, falls back to the form's own workspace, then company CSS. - `hasPassword` boolean, required - `submissionDeadline` string, date-time, nullable - `maxSubmissions` number, nullable - `defaultRecipientExpiryDays` number, nullable - `allowRecipientResubmission` boolean: Whether a personal recipient link may be submitted more than once. False (the default) is the survey/one-response-per-person shape: the second submission through the same link is refused. True is the shape where a form carries several outcomes a recipient reaches on separate visits (book a call now, sign the contract later), so the answers may come again. This governs ANSWERS only. The outcomes the platform itself owns stay once-per-recipient either way: a signature cannot be collected twice (`assertSignatureNotCollected`) and an active booking is not made twice (`assertNoActiveRecipientBooking`). Those are properties of the outcome, not preferences of the form. - `publishedAt` string, date-time, nullable - `requiresPublish` boolean, required: New v2-created forms set this true: the form is not publicly visible until its first publish. Existing forms stay false (grandfathered: the live entities keep serving until the owner first publishes). - `allowCopy` boolean, required: Opt-in gate for copying this form's structure. Default false: a public link does NOT make a form copyable. Owner must turn this on (or publish to the marketplace, which implies consent). Enforced in the import path and the marketplace "use template" path. Stops the one-click clone; it cannot stop someone manually recreating fields off the public page. - `marketplaceStatus` 'none' | 'pending' | 'approved' | 'rejected', required: Marketplace lifecycle. Only `approved` forms appear in the public read API and the in-app gallery. See {@link MarketplaceStatus}. - `marketplaceOfficial` boolean, required: "by meetergo" curated form. Operator-set. Controls badge + sort order. - `marketplaceCategory` string, nullable: Category slug for marketplace filtering (e.g. "lead-gen", "recruiting"). - `marketplaceDescription` string, nullable: Public listing description used for the gallery card and SEO copy. - `marketplaceListedAt` string, date-time, nullable: When the form was first approved/listed in the marketplace. - `marketplaceUseCount` number, required: How many times this form has been copied from the marketplace. - `reminders` Reminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `blockEmails` boolean, required - `fieldIds` string[], required - `funnelStepIds` string[], required - `disableModalInEmbed` boolean, required - `language` string, nullable: Language of the public form's own wording (buttons, placeholders, date pickers). Null follows the company language, which is what every form did before this column; set it when a form's questions are in another language, as a PDF import in German for an English account. - `selectMeetingTypeIds` string[], required - `meetingTypeId` string - `meetingTypeTemplateId` string - `locationFinderId` string, nullable, required - `locationFinderVersionId` string, nullable, required - `companyId` string, required: Shouldn't be nullable? - `qualifierIds` string[], required - `workspaceId` string, nullable - `userId` string - `crmOptions` MeetingCRMOptions, required - … - `cssSetting` CssSetting, required - … - `slug` string - `emailQualityGuard` boolean, required: Email Quality Guard - Blocks disposable emails and verifies email addresses exist Only applies when formFirst is enabled (Lead Capture Mode) - `enableWaitlist` boolean, required - `connectGuestJoinMinutesBeforeStart` number, nullable: Guest may enter this many minutes before a scheduled Connect call. - `connectGuestJoinMinutesAfterEnd` number, nullable: Guest may enter until this many minutes after a scheduled Connect call. - `runAsWebinar` boolean, required: Run bookings of this meeting type as a Connect webinar (roles, view-only attendees, moderated Q&A, attendance reporting) instead of an ordinary meeting. Only applies when `meetingInfo.channel` is CONNECT. Default false, so every existing meeting type keeps producing ordinary Connect meetings. - `webinarDefaults` object, nullable: Default webinar policy stamped onto each booking's Connect room. Null means the product defaults. Only read when `runAsWebinar` is on. - `notetakerRecording` 'on' | 'off', nullable: Whether the notetaker joins bookings of this meeting type. Null means the host's own default decides — which is not the same as `off`, and is why this is not a boolean. Stored as `varchar` rather than a Postgres enum for the same reason the notetaker's other vocabularies are: adding a word must never need a migration that locks a table. - `availability` Availability - `timezone` string, required - `id` string, required - `name` string, required - `schedule` WeeklySchedule, required - … - `useExplicitAvailability` boolean, required: When enabled, calendar events with the specified title are offered as bookable slots IN ADDITION to the weekly schedule (they behave like positive exceptions, see `UserAvailabilityService`). The weekly grid stays editable. Not to be confused with `scheduleSource`, which decides where the grid itself comes from. - `scheduleSource` object, required: Where the weekly schedule comes from. `manual` is the user typing it; `outlook` means it is read from the mailbox's Outlook working hours and the editor refuses direct schedule/timezone edits until switched back. Never read during slot calculation: to the availability engine an Outlook-sourced schedule is just a schedule. - `scheduleSourceConnectionId` string, nullable - `scheduleSyncedAt` string, date-time, nullable: Last time Outlook was consulted for this schedule (success or not). - `scheduleSyncError` object, nullable: Why the last consultation of Outlook could not update the schedule. - `explicitAvailabilityEventTitle` string, nullable: The calendar event title to look for when useExplicitAvailability is enabled. Events with this title will be treated as available booking slots. - `userId` string, required - `availabilityExceptions` AvailabilityException[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, date-time, nullable - `meetingType` MeetingType (recursive) - `meetingTypeTemplate` MeetingTypeTemplate - … - `resourceChannels` ResourceChannel[], required - … - `tags` string[], nullable: User-defined tags for organizing meeting types in the dashboard. Free-form strings, OR semantics for filtering. Mirrors the contact tags pattern. - `appointments` Appointment[] - `start` string, required - `end` string, required - `isCancelled` boolean, required: Determines whether appointment was cancelled - `spots` string, nullable: Per-appointment capacity for group bookings. Copied from meetingType.spots at creation time. Can be reduced to limit new bookees without cancelling existing attendees. When null, falls back to meetingType.spots. TODO: Ideally spots should be part of MeetingInfo (alongside groupBooking) so it gets copied naturally via the meetingInfo spread. Kept as top-level for now to avoid refactoring the existing meetingType.spots column + V4 API DTOs. - `rescheduledAt` string, date-time: Timestamp when appointment was rescheduled. Null if appointment is not rescheduled. - `rescheduledBy` string, nullable: Email address of the attendee, host, or operator who last rescheduled it. - `rescheduleCount` number, required: Number of times this appointment has been rescheduled. Used as the ICS SEQUENCE number so calendar clients recognize updates. - `bookedByUserId` string, nullable - `emailDeliveryIssues` object[], nullable: Mails the provider could not deliver for this appointment, one entry per address and kind. Written from AhaSend bounce webhooks so a typo in the attendee's address is visible before the appointment is missed. - … - `location` string - `scheduledReminders` ScheduledReminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `couponCode` string: Coupon code applied to this booking's payment (null if no coupon used) - `couponDiscountAmount` number: Discount amount applied via coupon (in the payment currency) - `note` string - `transcription` string, nullable: Full meeting transcription in markdown format - `summary` string, nullable: AI-generated summary of the meeting in markdown format - `actualStartAt` string, date-time, nullable: When the conversation actually ran, as whatever was in the call witnessed it: the first captured word for a recording, the first person in the room for a Connect call. `start` and `end` say when the meeting was booked for; these say what happened. Null until something that was there reports, and permanently null for a call nothing attended. - `actualEndAt` string, date-time, nullable - `attendanceCheckedAt` string, date-time, nullable: When something that could have witnessed the call finished looking. What tells "nobody came" apart from "nothing was watching": a past booking with this set and no `actualStartAt` is one a notetaker or the Connect room waited for and nobody joined, which the dashboard offers as a no-show to confirm. Never marks the no-show itself — that reaches the contact and their automations, and stays a person's decision. - `miraBrief` string, nullable: Mira's pre-meeting brief: who is coming, what was discussed last time, what is open. Written once on first request and kept, so opening the booking twice does not pay for the model twice. - `miraBriefAt` string, date-time, nullable - `occurrenceNumber` number, nullable: Position of this appointment within the recurring series (1-based). Null for non-recurring appointments. - `isBundleBooking` boolean, required - `id` string, required - `secret` string, required - `ics` string, required - `meetingInfo` MeetingInfo, required - … - `hostingInfo` HostingInfo, required - … - `cancel` BookingActionInfo, required - … - `crmOptions` MeetingCRMOptions, required - … - `bookedBy` User - … - `utmSource` string, nullable - `utmMedium` string, nullable - `utmCampaign` string, nullable - `utmContent` string, nullable - `utmTerm` string, nullable - `referrerUrl` string, nullable - `sourceChannel` object, nullable - `formRecipientId` string, nullable: `FormRecipient.id` when a personal form link routed this booking. Without it nothing connects an appointment to the person a printed link was minted for, so a returning recipient could only be offered a second calendar. With it they are shown the booking they already hold. Plain uuid, no FK: an appointment is a real commitment and must survive the deletion of the form that routed it. - `attendees` Attendee[]: `cascade: true` exists to INSERT attendees together with a new appointment. Never `save()` an EXISTING appointment with a loaded `attendees` array: the cascade diffs against a stale snapshot and orphan-nullifies attendees linked concurrently (group-booking joins). Link/unlink attendee rows individually instead. - … - `attendeeIds` string[], required - `roundRobinEntries` RoundRobinEntry[] - … - `meetingType` MeetingType (recursive) - `meetingTypeId` string, required: @todo should not be nullable, but prod has some null values also recently - `bookingBlockId` string, nullable, required: The booking block this appointment was booked into, set only when the invitee arrived through that block's customer link. It is the sole answer to "which bookings are in this reserved day", and deleting the day cancels exactly these. Matching on host and time instead would sweep in ordinary meetings that merely overlap. Deliberately no foreign key: the row must outlive the block it names. - `hostIds` string[], required - `companyId` string, required - `resolvableErrors` AppointmentResolvableError[] - … - `bufferReservations` BufferReservation[] - … - `paymentId` string - `recapSharedAt` string, date-time, nullable: When the host turned this meeting's recap into a shareable link, or null while it is private. A timestamp rather than a boolean because "when did we start sharing this" is the question asked after a recap turns up somewhere unexpected. Sharing is off until the host asks for it: a transcript is the most sensitive thing the product stores, and a link that exists by default is a link that leaks by default. - `notetakerNoticeEmailedAt` string, date-time, nullable: When the invitees were told by email that this meeting will be recorded. Stamped by the confirmation email when its footer carried the recording disclosure, and otherwise by the advance-notice sweep when it sends the dedicated notice 24 hours ahead. One column, two writers, one rule: a null here on a meeting that will be recorded is a notice still owed. - `preCallBriefWarmedAt` string, date-time, nullable: When the structured Connect brief was generated ahead of the call. Bookkeeping for the warming sweep, not a third brief: the text itself lives in the cache the in-call panel already reads, and this is only how the sweep knows it has done a booking. Null means the panel would still pay for the model on first open, which is the wait this removes. - `recurringSeries` RecurringSeries - … - `recurringSeriesId` string, nullable - `bundle` MeetingTypeBundle - … - `bundleId` string, nullable - `bundleItems` AppointmentBundleItem[]: Bundle items for this appointment (details of each meeting type in the bundle). Only populated for bundle bookings. - … - `qualifiers` Qualifier[], nullable - `index` number, required - `routingAction` 'customPage' | 'externalRedirect' | 'eventRedirect' | 'requestCallback' | 'contactForm' | 'instantCall' | 'formRedirect' | 'teamPageRedirect', required - `isFallback` boolean, required - `queue` Queue - … - `meetingType` MeetingType (recursive) - `routeToCrmOwner` boolean, required: Route to the Salesforce owner of the record matched by attendee email: when true and the routing lookup matched a Contact/Lead, the owner's meetergo user is pinned as host (same mechanism as `meetingTypeUser`, which — being an explicit choice — still wins when set). Falls back to the normal queue when the owner can't be resolved to an eligible host. - `crmOwnerField` string, nullable: Which Salesforce User-lookup field supplies the host when `routeToCrmOwner` is on, as a condition-style path (`Contact.OwnerId`, `Account.OwnerId`, `Contact.SDR__c`). Null means "owner of whichever record matched", which is what every rule written before this column existed meant — so null must keep behaving exactly that way. - `meetingTypeUser` User - … - `form` Form, required - … - `redirectForm` Form - … - `teamPage` Workspace - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` string, required - `contactFormEmail` string - `externalRedirectLink` string - `customPageContent` LocalisedContent - … - `customFormTitle` LocalisedContent - … - `showThankYouOnCustomPage` boolean, required - `expression` Expression, required - … - `queueId` string - `meetingTypeId` string - `meetingTypeUserId` string - `formId` string, required - `redirectFormId` string - `teamPageId` string - `reminders` Reminder[] - `meetingTypes` MeetingType[] - `meetingTypeTemplates` MeetingTypeTemplate[] - … - `forms` Form[] - … - `pipelines` Pipeline[] - … - `workspace` Workspace - … - `scheduledReminders` ScheduledReminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `id` number, required - `name` string, required - `enabled` boolean, required - `scope` object, required - `triggers` ReminderTrigger[], required - … - `companyId` string, required - `workspaceId` string - `userId` string: Maybe shouldnt be nullable - `formMeetingTypes` Form[] - `id` string, required - `name` string, required - `title` object, required: Title to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `actionButtonText` object, required: Button text to be displayed in booking in multiple languages. Key is Language Code, Value is title in specified locale. - `blockedEmails` string[], required - `fields` FormField[], required - … - `funnelSteps` FunnelStep[], required - … - `default` boolean, required: Indicates default form that can be modified, but should not be deleted - `funnelConditions` FunnelQualifier[], required - … - `useFullName` boolean, required - `skipForm` boolean, required - `showProgressBar` boolean - `useMeetingTypeSelection` boolean, required - `selectMeetingTypes` MeetingType[], required - `selectMeetingTypeOrder` string[]: Stores the order of meeting types for selection pages. If empty/null, use default order from selectMeetingTypeIds. - `selectionPageLayout` 'grid' | 'list' | 'cards' | 'tiles' | 'spotlight' | 'minimal' | 'showcase', required - `selectionPageDescription` object, required: Intro text shown under the selection page title, per language code. - `selectionPageSocialLinks` object, required: Social and contact links shown on the selection page. - `meetingType` MeetingType (recursive) - `meetingTypeTemplate` MeetingTypeTemplate - … - `standaloneKind` 'routing' | 'selection' | 'locationFinder': Explicit discriminator for standalone public experiences. Null preserves the legacy relation-based classification during the mixed-version rollout. - `qualifiers` Qualifier[] - … - `workspace` Workspace - … - `formTheme` FormTheme - … - `structureType` 'FORM_ONLY' | 'FUNNEL_WITH_FORM' | 'FUNNEL_ONLY', required: slug used in routing form only. - `sendRoutingFormSubmissionNotification` boolean, required - `notificationUserId` string, nullable - `notificationEmail` string, nullable - `contactTags` string[], required: Tags written onto the contact a submission creates or updates. Additive: a submission never removes a tag. This is where a newsletter audience grows by itself, and where a sequence trigger gets its tag from (`functions/contact-tags.ts`, configured in the Newsletter app). - `marketingConsentDoubleOptIn` boolean, required: Whether a ticked marketing-consent field is only recorded after the contact confirms it from their inbox. Off: the tick itself is the consent. On: the submission sends a confirmation mail and the ledger row is written when its link is used (`FormMarketingConsentService`). - `redirectAfterSubmission` boolean, required - `redirectUrl` string, nullable - `allowSaveAndReturn` boolean, required - `prefillLock` PrefillLock - … - `salesforceAccountMatch` SalesforceAccountMatch - … - `showCompanyLogo` boolean, required - `webhookUrl` string, nullable - `cssWorkspaceId` string, nullable: Which workspace's CSS to use when cssSetting.mode is Company. If null, falls back to the form's own workspace, then company CSS. - `hasPassword` boolean, required - `submissionDeadline` string, date-time, nullable - `maxSubmissions` number, nullable - `defaultRecipientExpiryDays` number, nullable - `allowRecipientResubmission` boolean: Whether a personal recipient link may be submitted more than once. False (the default) is the survey/one-response-per-person shape: the second submission through the same link is refused. True is the shape where a form carries several outcomes a recipient reaches on separate visits (book a call now, sign the contract later), so the answers may come again. This governs ANSWERS only. The outcomes the platform itself owns stay once-per-recipient either way: a signature cannot be collected twice (`assertSignatureNotCollected`) and an active booking is not made twice (`assertNoActiveRecipientBooking`). Those are properties of the outcome, not preferences of the form. - `publishedAt` string, date-time, nullable - `requiresPublish` boolean, required: New v2-created forms set this true: the form is not publicly visible until its first publish. Existing forms stay false (grandfathered: the live entities keep serving until the owner first publishes). - `allowCopy` boolean, required: Opt-in gate for copying this form's structure. Default false: a public link does NOT make a form copyable. Owner must turn this on (or publish to the marketplace, which implies consent). Enforced in the import path and the marketplace "use template" path. Stops the one-click clone; it cannot stop someone manually recreating fields off the public page. - `marketplaceStatus` 'none' | 'pending' | 'approved' | 'rejected', required: Marketplace lifecycle. Only `approved` forms appear in the public read API and the in-app gallery. See {@link MarketplaceStatus}. - `marketplaceOfficial` boolean, required: "by meetergo" curated form. Operator-set. Controls badge + sort order. - `marketplaceCategory` string, nullable: Category slug for marketplace filtering (e.g. "lead-gen", "recruiting"). - `marketplaceDescription` string, nullable: Public listing description used for the gallery card and SEO copy. - `marketplaceListedAt` string, date-time, nullable: When the form was first approved/listed in the marketplace. - `marketplaceUseCount` number, required: How many times this form has been copied from the marketplace. - `reminders` Reminder[] - … - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `blockEmails` boolean, required - `fieldIds` string[], required - `funnelStepIds` string[], required - `disableModalInEmbed` boolean, required - `language` string, nullable: Language of the public form's own wording (buttons, placeholders, date pickers). Null follows the company language, which is what every form did before this column; set it when a form's questions are in another language, as a PDF import in German for an English account. - `selectMeetingTypeIds` string[], required - `meetingTypeId` string - `meetingTypeTemplateId` string - `locationFinderId` string, nullable, required - `locationFinderVersionId` string, nullable, required - `companyId` string, required: Shouldn't be nullable? - `qualifierIds` string[], required - `workspaceId` string, nullable - `userId` string - `crmOptions` MeetingCRMOptions, required - … - `cssSetting` CssSetting, required - … - `slug` string - `locations` string[], required - `bookingFrequencies` BookingFrequency[]: @todo this doesn't need to be OneToMany and maybe not even a relation (unless different frequencies per user for a queue are needed) - `frequency` HostBookingFrequency, required - … - `userId` string, required - `meetingTypeId` string, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `deletedAt` string, nullable - `timeFormat` '12' | '24', required - `provisionalBookings` ProvisionalBookingPayload[] - `id` string, required: Generated ID - `dto` BookingDto, required - … - `locationSelectionContext` object, nullable, required: Trusted Finder selection retained across confirmation flows. - `type` 'doubleOptIn' | 'requireHostConfirmation', required - `company` Company, required - … - `hosts` User[] - … - `meetingType` MeetingType, required (recursive) - `Appointment` Appointment - … - `appointmentId` string - `queueBookingInfo` NextQueueHostsSelectionReasonDto - … - `createdAt` string, date-time, required - `deletedAt` string, date-time, nullable, required - `status` 'pending' | 'confirmed' | 'expired' | 'declined_by_host', required: Status of the provisional booking request - `declineReason` string: Reason provided by host when declining (optional) - `resolvedAt` string, date-time: Timestamp when the booking was declined or expired - `expiryWarningSent` boolean, required: Whether the "expiring soon" warning email has been sent to the host - `expiresAt` string, date-time: When this provisional booking expires. Set at creation time based on company's provisionalBookingExpiryHours or default 72h. - `start` string, date-time: Reserved slot start. Used by availability checks so pending payloads block the slot for other bookers until the payload is confirmed, declined, or expired. - `end` string, date-time: Reserved slot end. - `accountOwnerMatchingEnabled` boolean, required: Account-owner matching: route a round-robin booking to the user who already owns the booker's account. Owner is resolved via past meetergo bookings + connected CRMs (Pipedrive, HubSpot, Salesforce). Requires `featureAccess.accountOwnerMatching` (Premium). - `accountOwnerMatchingScope` object, required: Where to draw the eligible-owner pool from. Picks one scope per meeting type (no inheritance). - `meetingType`: uses `accountOwnerMatchingUserIds` below - `workspace`: every active member of the meeting type's workspace - `company`: every active member of the meeting type's company - `accountOwnerMatchingUserIds` string[], required: Eligible owners when scope is `meetingType`. Ignored otherwise. - `accountOwnerMatchingAllowNonQueueHosts` boolean, required: If false (default), matched owners must also be queue members for the round-robin to route to them. If true, a matched pool user can host even when not in the queue. - `accountOwnerMatchingFallback` object, required: Behaviour when no owner matches (or matched owner has no slots). - `normalRoundRobin`: fall back to standard host availability - `showEmpty`: show no slots - `salesforceHostPoolEnabled` boolean, required: Draw the bookable hosts for this meeting type from Salesforce instead of from the statically configured queue: the booking page supplies an account key, and the pool is the account's team as {@link salesforceHostPool} describes it. The resolved pool is applied as a queue subset, so round-robin, fairness and host validation all keep working on it unchanged. Every failure — no connection, no match, timeout, nobody left after filtering — falls back to the full queue. Wrong advisor is recoverable in the CRM, a lost lead is not. Requires `featureAccess.salesforceRouting`. - `salesforceHostPool` SalesforceHostPoolSetting - `object` string, required - `accountField` string, required - `accountKeyField` string, required - `userField` string, required - `activeField` object, nullable - `orderByField` object, nullable - `dateField` object, nullable - `skill` SalesforceHostPoolSkillSetting - … - `internalNotes` string, nullable: Internal note for organizers. Never shown to customers. Used for project keys, partner info, briefing notes, etc. - `replyTo` string, nullable: Override the Reply-To address for notification emails sent for this meeting type. When set, takes precedence over the company `useNoReplyAddress` flag and the default host email fallback. Useful for sales/support teams that want replies routed to a shared inbox instead of the individual host. - `enableWithdrawalButton` boolean, required: Show the EU/German withdrawal button ("Widerrufsbutton") on the booking confirmation page. Required from 19 June 2026 (§ 356a BGB) for B2C distance contracts with a right of withdrawal. Off by default. Hosts must opt in per meeting type. Disable for leisure-services tied to a fixed date (concerts, events) which are exempt under § 312g Abs. 2 Nr. 9 BGB. - `id` string, required - `activationSessionId` string, nullable, required - `activationResourceKey` string, nullable, required - `crmOptions` MeetingCRMOptions, required - `hubspotContactSync` boolean, required - `hubspotContactStage` string, required - `hubspotCompanySync` boolean, required - `hubspotCompanyStage` string, required - `hubspotCompanyMatchingField` string, required - `hubspotDealSync` boolean, required - `hubspotDealStage` string, required - `hubspotPipelineId` string, required - `pipedriveDealSync` boolean, required - `pipedriveContactSync` boolean, required - `pipedrivePipelineId` number, nullable, required - `pipedriveStageId` number, nullable, required - `pipedriveUseExistingDeal` boolean, required - `closeDealSync` boolean, required - `closeContactSync` boolean, required - `closePipelineId` object, nullable, required - `closeStatusId` object, nullable, required - `closeUseExistingDeal` boolean, required - `centralStationContactSync` boolean, required - `centralStationDealSync` boolean, required - `centralStationPipelineId` number, nullable, required - `centralStationStageId` number, nullable, required - `linkandoSyncEnabled` boolean, required - `linkandoPlaybookId` number, nullable, required - `linkandoTemplateId` number, nullable, required - `evalancheEnabled` boolean, required - `klicktippEnabled` boolean, required - `getResponseEnabled` boolean, required - `getResponseCampaignId` string, nullable, required - `brevoEnabled` boolean, required - `sevdeskEnabled` boolean, required - `sevdeskCategoryId` number, nullable, required - `lexwareEnabled` boolean, required - `professionalWorksEnabled` boolean, required - `abAgentaEnabled` boolean, required - `smartWeContactSync` boolean, required - `smartWeCompanySync` boolean, required - `smartWeDealSync` boolean, required - `smartWeDealStage` string, required - `salesforceSyncEnabled` boolean, required - `salesforceCaseSync` boolean, required - `salesforceLeadSync` boolean, required - `salesforceOpportunitySync` boolean, required - `salesforceLeadStatus` string, required - `salesforceCaseStatus` string, required - `salesforceOpportunityStage` string, required - `salesforceDefaultObjectType` string, required - `internalCrmPipelineId` object, nullable, required - `internalCrmStageId` object, nullable, required - `crmOptInFieldName` object, nullable, required - `ics` IcsInfo, required - `title` LocalisedContent, required - … - `description` LocalisedContent, required - … - `location` LocalisedContent, required - … - `requireGuestConfirmation` boolean - `daysIntoFuture` DaysIntoFutureSetting, required - `mode` string, required - `bookingLimit` number - `countMode` string - `rangeMin` string, date-time - `rangeMax` string, date-time - `enableCalendarInviteNotification` boolean, required: New notification setting - use calendar invites instead of email notifications. When this option is enabled, booking confirmation notification and cancellation notification are handled by calendar connection. A google/outlook connection is required. It will be used to create calendar invite with notification. All meeting types pre-migration use email notifications. Introduced in order to mitigate duplicate invites, cancellation handling in calendar and overall improve both host and attendee experience. - `useSchedule` boolean, required: Override individual host's availability If true, availability selected for that meeting type will be used as common availability for all hosts. Move to meetingOptions? - `useCompanyLogo` boolean, required: Move to meetingOptions? - `useTeamLogo` boolean, required: Show team logo instead of company logo (for queue/round-robin meeting types) - `useCustomInvite` boolean, required: Move to meetingOptions? - `disableActionButtons` boolean, required: Move to meetingOptions? - `showConfetti` boolean, required: Whether to show confetti animation on the confirmation page - `useCustomForm` boolean, required - `formId` string - `inCompanyPage` boolean, required - `formFirst` boolean, required: Move to meetingOptions? - `communicationSettings` CommunicationSettings - `attendeeMeetingConfirmationStatus` 'useCompanyTemplate' | 'useMeetingTypeTemplate' | 'disabled', required: @todo migrate to boolean, only disabled does something - `attendeeMeetingConfirmation` EmailTemplate, required - … - `hostMeetingConfirmationStatus` 'useCompanyTemplate' | 'useMeetingTypeTemplate' | 'disabled', required: @todo migrate to boolean, only disabled does something - `hostMeetingConfirmation` EmailTemplate, required - … - `attendeeMeetingCancelledStatus` 'useCompanyTemplate' | 'useMeetingTypeTemplate' | 'disabled', required: @todo migrate to boolean, only disabled does something - `attendeeMeetingCancelled` EmailTemplate, required - … - `hostMeetingCancelledStatus` 'useCompanyTemplate' | 'useMeetingTypeTemplate' | 'disabled', required: @todo migrate to boolean, only disabled does something - `hostMeetingCancelled` EmailTemplate, required - … - `attendeeMeetingRescheduledStatus` 'useCompanyTemplate' | 'useMeetingTypeTemplate' | 'disabled', required: @todo migrate to boolean, only disabled does something - `attendeeMeetingRescheduled` EmailTemplate, required - … - … truncated; see the full OpenAPI document linked below ## Other responses - `400`: The request did not validate. `message` lists the constraints that failed. - `401`: Missing, malformed, or expired credentials. - `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it. - `404`: No such resource in your account. Resources belonging to another account are reported the same way. - `429`: Rate limited. Back off and retry. --- [API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)