Skip to content
BuildBase

Plan Features and Limits

Every feature, limit and quota slug a BuildBase plan refusal names in feature, limitSlug or quotaSlug, and what each one gates.

When your organization's own BuildBase plan refuses a call, the 402 body names the slug it refused on. This page lists every slug BuildBase can name, so you can look one up and tell your team what to change.

{
  "success": false,
  "code": "PLAN_LIMIT_REACHED",
  "message": "Your plan includes 5 workflows. Upgrade for more, or remove one.",
  "limitSlug": "max-workflows",
  "limit": 5,
  "current": 5
}

Which field names the slug

codeFieldWhat it meansSection
FEATURE_NOT_IN_PLANfeatureThe plan does not include the capability at allFeatures
PLAN_LIMIT_REACHEDlimitSlugThe capability is on the plan and its ceiling is reached. The body adds limit and currentLimits
QUOTA_EXHAUSTEDquotaSlugThis period's allowance is used up and the plan allows no overage. The body adds included, consumed and wantedQuotas

All three are 402. The error codes page says what to do about each. A limit of -1 means unlimited and 0 means none.

const res = await fetch(url, { method: 'POST', headers, body });
if (res.status === 402) {
  const body = await res.json();
  const slug = body.feature ?? body.limitSlug ?? body.quotaSlug;
  console.warn(`Refused on ${slug}: ${body.message}`);
}

Note

These are the slugs of your organization's plan with BuildBase. The plans you sell to your own users use the slugs you create in the console (max-projects, advanced-analytics), and a refusal on one of those names your slug. See Entitlement Checks.

The tables below are generated from the platform's entitlement registry, so they list every slug that exists, whether or not your plan carries it. Which plan includes what, and how much, is on the pricing page and in Plan & Billing in the console; this page states no plan amounts.

How to read the columns:

  • Under: the feature a limit or quota bounds, or the capability a feature belongs to. When that feature is not on the plan, you get FEATURE_NOT_IN_PLAN for it rather than a limit of zero.
  • Old key, read as: a slug kept for plans that still carry it. A plan holding either key is served through the newer one.
  • Not enforced yet: the slug exists in the registry, but no route refuses on it yet.
  • On your own account plan: the slug belongs to your personal plan (self-hosting), not to an organization's.
  • End users get a neutral refusal, not a 402: the create belongs to your end user (signing up, allowing push, filling in a form). They never see a billing message, and your organization is told through an event instead.

Features

feature valueWhat it gatesCategoryUnderNotes
auth-coreauthenticationauth--
auth-magic-linkauth magic linkauth--
auth-email-otpemail sign-in codesauthauth-magic-link-
auth-custom-oidccustom OIDC sign-in providerauth--
auth-smsphone sign-in codesauth--
auth-web3crypto wallet sign-inauth--
auth-anonymousguest usersauth--
auth-passkeyspasskey sign-inauth--
custom-auth-domaincustom auth domainsauth--
auth-sso-enterpriseenterprise features (single sign-on and the company tools)authauth-core-
auth-directory-syncdirectory syncauthauth-sso-enterprise-
auth-white-label-portalauth white label portalauth-Old key, read as white-label
oauth-serverthe OAuth 2.0 serverauth--
agent-readinessagent readinessauth--
auth-api-tokensauth api tokensauth--
stripe-billingStripe billingbilling--
metered-billingmetered billingbilling--
multi-currencymultiple currenciesbilling--
billing-seat-pricingper-seat billingbilling--
creditscreditsbilling--
billing-user-plansplans for usersbilling--
billing-add-onsadd-onsbilling--
marketplace-sellingselling through Stripe Connectbilling--
marketplace-live-sellinglive selling with real moneybillingmarketplace-selling-
affiliate-trackingaffiliate trackingbilling--
email-campaignsemail campaignsmessaging--
email-templatesemail templatesmessaging--
email-template-libraryemail template librarymessaging--
email-domain-verificationemail domain verificationmessaging--
email-byo-smtpemail byo smtpmessagingemail-domain-verification-
email-managed-senderemail managed sendermessagingemail-campaigns-
email-oauth-sendersemail oauth sendersmessagingemail-domain-verification-
email-open-click-trackingemail open click trackingmessaging--
email-unsubscribe-groupsemail unsubscribe groupsmessaging--
push-notificationsweb push notificationsmessaging--
workflowsworkflowsautomation--
workflow-audit-logworkflow audit logautomation--
realtime-workflow-eventsrealtime workflow eventsautomationworkflows-
workflow-dlq-retryworkflow dlq retryautomationworkflows-
wf-http-webhookHTTP request nodesautomationworkflows-
wf-data-transformdata transform nodesautomationworkflows-
wf-wait-for-eventwait-for-event nodesautomationworkflows-
wf-audience-complianceaudience compliance nodesautomationworkflows-
wf-split-randomrandom split nodesautomationworkflows-
wf-grant-creditsgrant credits nodesautomationworkflows-
workspaces-rbacworkspace roles and permissionstenancy--
workspace-mode-platformshared team workspacestenancy--
workspace-activity-logworkspace activity logtenancy-Old key, read as workspace-activity-retention-days
org-ownership-transferorg ownership transfertenancy--
content-blogsblogscontent--
content-docsdocscontent--
content-faqsFAQscontent--
content-testimonialstestimonialscontent--
content-rich-blocksrich content blockscontent--
user-managementuser managementplatform--
forms-crmforms and CRMplatform--
audience-smart-listsaudience smart listsplatformforms-crm-
audience-bulk-importaudience bulk importplatformforms-crm-
feature-flagsfeature flagsplatform--
flag-advanced-targetingflag advanced targetingplatformfeature-flags-
collections-modulecollections moduleplatform--
links-analyticslink analyticsplatform--
assets-media-libraryassets media libraryplatform--
webhooks-integrationswebhooks and integrationsplatform--
integration-mondaythe monday.com integrationplatform--
integration-vercelintegration vercelplatform--
slack-notificationsslack notificationsplatform--
deploymentsdeploy hooksplatform--
website-publishpublishing to your siteplatformdeployments-
i18ninternationalisationplatform--
tracking-tagstracking tagsplatform--
white-labelremoving the BuildBase badgehosting-Granting it removes something
self-hostingself hostinghosting-On your own account plan
dedicated-clusterdedicated clusterhosting-Not enforced yet
email-supportemail supportsupport-Not enforced yet
priority-supportpriority supportsupport-Not enforced yet
dedicated-supportdedicated supportsupport-Not enforced yet
sla-uptime-targetsla uptime targetsupport-Not enforced yet

Limits

limitSlug valueWhat it countsCategoryUnderNotes
max-social-providerssocial sign-in providersauth--
max-passkeys-per-userpasskeys per userauthauth-passkeysEnd users get a neutral refusal, not a 402
max-auth-domainscustom domainsauthcustom-auth-domain-
max-enterprisesenterprisesauthauth-sso-enterprise-
session-ttl-dayssession length (days)authauth-core-
auth-configsauth configsauthoauth-serverOld key, read as max-oauth-clients
max-oauth-clientsOAuth clientsauthoauth-server-
max-redirect-urls-per-clientredirect URLs per clientauthoauth-server-
max-dynamic-clientsdynamic clientsauthagent-readinessEnd users get a neutral refusal, not a 402
max-connected-agentsconnected agentsauthagent-readinessEnd users get a neutral refusal, not a 402
max-api-tokensAPI keysauthauth-api-tokens-
api-token-max-ttl-daysAPI key expiry (days)authauth-api-tokens-
max-api-rolesapi rolesauthauth-api-tokens-
auth-audit-retention-daysauth audit log history (days)auth--
max-active-sessions-per-useractive sessions per userauthauth-coreEnd users get a neutral refusal, not a 402
max-devices-per-userdevices per userauthauth-coreEnd users get a neutral refusal, not a 402
max-plansplansbillingstripe-billing-
max-plan-versions-per-planplan versions per planbillingstripe-billing-
max-plan-groupsplan groupsbillingstripe-billing-
max-subscription-itemssubscription itemsbillingstripe-billing-
max-item-categoriesitem categoriesbillingstripe-billing-
max-pricing-variantspricing variantsbillingstripe-billing-
quota-usage-log-retention-daysquota usage log retention day (days)billingmetered-billing-
max-currenciescurrenciesbillingmulti-currency-
max-credit-packagescredit packagesbillingcredits-
credit-expiry-max-dayscredit expiry max day (days)billingcredits-
max-add-on-offersadd-on offersbillingbilling-add-ons-
max-item-typesactive item typesbillingmarketplace-selling-
max-affiliate-programsaffiliate programsbillingmarketplace-selling-
stripe-webhook-retention-daysstripe webhook retention day (days)billingstripe-billing-
max-campaignsemail campaignsmessagingemail-campaigns-
max-campaign-recipientsrecipients per campaignmessagingemail-campaigns-
max-transactional-emails-per-daytransactional emails per daymessagingauth-coreEnd users get a neutral refusal, not a 402
max-email-templatesemail templatesmessagingemail-templates-
max-email-draftsemail draftsmessagingemail-templates-
max-email-domainsemail domainsmessagingemail-domain-verification-
max-email-senderssender addressesmessagingemail-domain-verification-
max-email-sender-accountsemail sender accountsmessagingemail-domain-verificationOld key, read as max-email-senders
email-tracking-retention-daysemail tracking retention day (days)messagingemail-open-click-tracking-
email-history-retention-daysemail history retention day (days)messagingemail-campaigns-
max-unsubscribe-groupsunsubscribe groupsmessagingemail-unsubscribe-groups-
max-custom-merge-tagscustom merge tagsmessagingemail-templates-
max-notification-eventsnotification eventsmessaging--
max-push-subscriberspush subscribersmessagingpush-notificationsEnd users get a neutral refusal, not a 402
max-push-campaignspush campaignsmessagingpush-notifications-
push-log-retention-dayspush log retention day (days)messagingpush-notifications-
max-workflowsworkflowsautomationworkflows-
max-nodes-per-workflownodes per workflowautomationworkflows-
max-workflow-versionsworkflow versionsautomationworkflows-
max-pending-waitspending waitsautomationwf-wait-for-event-
max-workflow-templatesworkflow templatesautomationworkflows-
workflow-log-retention-daysworkflow log retention day (days)automationworkflows-
workflow-run-retention-daysworkflow run retention day (days)automationworkflows-
workflow-action-retention-daysworkflow action retention day (days)automationworkflows-
max-concurrent-connectionsconcurrent connectionsautomationrealtime-workflow-events-
workspacesworkspacestenancyworkspaces-rbacEnd users get a neutral refusal, not a 402
max-workspaces-per-userworkspaces per usertenancyworkspaces-rbac-
team-membersteam memberstenancyworkspaces-rbac-
max-workspace-usersworkspace userstenancyworkspaces-rbacEnd users get a neutral refusal, not a 402
max-org-membersorg memberstenancyworkspaces-rbacOld key, read as team-members
max-pending-invitationspending invitationstenancyworkspaces-rbac-
max-whitelisted-userswhitelisted userstenancyworkspaces-rbac-
custom-rolescustom rolestenancyworkspaces-rbac-
max-custom-workspace-rolescustom workspace rolestenancy--
max-custom-workspace-permissionscustom workspace permissionstenancy--
workspace-activity-retention-daysworkspace activity retention day (days)tenancy--
org-audit-retention-daysorg audit retention day (days)tenancy--
max-organizationsorganizationstenancy--
environmentsenvironments besides productiontenancy--
max-blog-postsblog postscontentcontent-blogs-
max-blog-authorsblog authorscontentcontent-blogs-
max-blog-foldersblog folderscontentcontent-blogs-
max-blog-tagsblog tagscontentcontent-blogs-
max-folder-depthlevels of folder nestingcontentcontent-blogs-
max-docs-pagesdocs pagescontentcontent-docs-
max-docs-authorsdocs authorscontentcontent-docs-
max-docs-foldersdocs folderscontentcontent-docs-
max-docs-tagsdocs tagscontentcontent-docs-
max-faqsFAQscontentcontent-faqs-
max-faq-collectionsfaq collectionscontentcontent-faqs-
max-faqs-per-collectionfaqs per collectioncontentcontent-faqs-
max-testimonialstestimonialscontentcontent-testimonials-
max-rich-content-blocksrich content blockscontentcontent-rich-blocks-
max-end-usersend usersplatformuser-managementEnd users get a neutral refusal, not a 402
max-user-attributesuser attributesplatformuser-management-
max-user-tagsuser tagsplatformuser-management-
max-user-listsuser listsplatformuser-management-
max-smart-user-listssmart user listsplatformaudience-smart-lists-
user-activity-retention-daysuser activity retention day (days)platformuser-management-
max-audience-contactsaudience contactsplatformforms-crm-
max-smart-listssmart listsplatformaudience-smart-lists-
max-audience-listsaudience listsplatformforms-crm-
max-list-memberslist membersplatformforms-crm-
max-audience-attributesaudience attributesplatformforms-crm-
max-audience-tagsaudience tagsplatformforms-crm-
audience-activity-retention-daysaudience activity retention day (days)platformforms-crm-
form-countformsplatformforms-crm-
flag-countfeature flagsplatformfeature-flags-
max-workspace-feature-flagsworkspace feature flagsplatformfeature-flags-
max-beta-signupsbeta signupsplatform-End users get a neutral refusal, not a 402
collectionscollectionsplatformcollections-module-
max-collection-recordscollection recordsplatformcollections-moduleEnd users get a neutral refusal, not a 402
max-fields-per-collectionfields per collectionplatformcollections-module-
max-collection-versionscollection versionsplatformcollections-module-
max-short-linksshort linksplatformlinks-analytics-
link-analytics-retention-dayslink analytics retention day (days)platformlinks-analytics-
max-asset-size-mbasset size mbsplatformassets-media-library-
max-assetsassetsplatformassets-media-library-
max-asset-tagsasset tagsplatformassets-media-library-
webhook-endpointswebhook endpointsplatformwebhooks-integrations-
max-events-per-endpointevents per endpointplatformwebhooks-integrations-
webhook-delivery-retention-dayswebhook delivery retention day (days)platformwebhooks-integrations-
max-monday-connectionsmonday connectionsplatformintegration-monday-
max-slack-eventsslack eventsplatformslack-notifications-
max-deploy-hooksdeploy hooksplatformdeployments-
analytics-retention-daysanalytics retention day (days)platform--
max-tracking-scriptstracking scriptsplatformtracking-tags-
conversion-log-retention-daysconversion log retention day (days)platformtracking-tags-
max-installationsinstallationshostingself-hostingOn your own account plan
max-orgs-per-installationorgs per installationhostingself-hostingOn your own account plan

Quotas

quotaSlug valueWhat it meters each periodCategoryUnderNotes
magic-links-sentmagic linksauthauth-magic-link-
emails-sentmarketing emailsmessagingemail-campaigns-
campaigns-per-monthcampaignsmessagingemail-campaigns-
push-sentpush notificationsmessagingpush-notifications-
workflow-runsworkflow runsautomationworkflows-
workflow-node-executionsworkflow node executionsautomationworkflows-
workflow-trigger-eventsworkflow trigger eventsautomationworkflows-
content-readscontent readscontent--
maumonthly active usersplatformuser-management-
import-rows-per-monthimported rowsplatformaudience-bulk-import-
form-submissionsform submissionsplatformforms-crm-
web-analytics-eventsweb analytics eventsplatform-End users get a neutral refusal, not a 402
link-clickslink clicksplatformlinks-analytics-
storage-gbGB of storageplatformassets-media-library-
webhook-deliverieswebhook deliveriesplatformwebhooks-integrations-
deployments-per-monthdeploysplatformdeployments-
ip-enrichment-lookupsIP enrichment lookupsplatform--
conversion-events-sentconversion eventsplatformtracking-tags-

Next steps