Company Configuration
Audience: Engineering · QA · Support · Management · Where in app: Internal (surfaced across Settings screens) · Plan availability: All plans (individual features gated)
Most tenant behavior is controlled by fields on the companies collection (CompanyModel, backend MongoDB). This is the canonical list of those fields, grouped by area. Use it to answer "is X enabled for this tenant / where do I configure Y?" and to map a Settings screen back to the field it writes.
Field names below are the stored config keys. Many map to a Settings UI screen but some are super-admin-only gates (often suffixed
_allowed). When a value is plan- or agency-gated, verify against the live entitlement matrix.
Identity & branding
company_name,website_url,industry,agent_typetimezone,timezone_offsetlogo(FileModel ref)affiliate_link,affiliate_link_enabled
Visibility / installation
visibility— widget on/offmobile_disable— hide on mobilewidget_installed,widget_installed_at
Widget design
widget_design.*— message/button/header/footer/call-background colors, chatbot auto-trigger colorsprimary_color,secondary_color,position(right/left)launcher_style(bubble / middle / expended / bar / welcome / chat-pill / icon)mobile_launcher_stylechat_window_type(extend/small),chat_window_color
Channels
communication_options.allow_chat / allow_video_call / allow_audio_callcommunication_options.chat_label / video_call_label / audio_call_labelcommunication_options.take_phone_number_before_callcommunication_options.visitor_video_permissionscommunication_options.take_over_permissions
Working hours
working_hours[]—day,start_time(HH:MM),end_time(HH:MM)- Per-user override on
users.working_hours
Online / offline copy
online_title_text,online_title_text_sub_headingoffline_title_text,offline_title_text_sub_headingchatbot_online_message,chatbot_online_questions[],chatbot_online_after_questions_messagechatbot_offline_message,chatbot_offline_questions[],chatbot_offline_after_questions_message
Contact-information capture
contact_information_questions.name / email / phone— eachenabled+question_text
Chatbot type
chatbot_enabled— master switchchatbot_type—basicorflow
AI chat
ai_chat.setting(quick / advanced)ai_chat.agent_instructions,agent_name,tone,response_sizeai_chat.post_chat_tags(Mixed:{ builtin: { engaged }, custom: [{description, tag}] }) — post-chat GHL outcome tags; applied byChatTranscriptEmailJobwhenever GHL is connected (thewidget_chat_tags_enabledgate was removed 2026-09-25). A blank builtin tag defaults to its key.
AI calling (outbound)
ai_calling.enable,setting(quick / advanced)ai_calling.agent_instructions,agent_name,tone,response_size,greeting_messageai_calling.post_call_tags(Mixed) — post-call GHL outcome tags for widget AI voice calls; applied byAiCallGhlTranscriptSyncJobwhenever GHL is connected (widget_call_tags_enabledremoved 2026-09-25).
AI inbound call
ai_inbound_call.enable,model,model_provider,agent_voice_id,agent_language
AI outbound campaigns
ai_outbound_call_enabled(tenant toggle)ai_outbound_call_allowed(admin gate)ai_outbound_call_agents[]— multi-agent (each with prompt, voice, model, webhook_secret)
AI auto-trigger (chatbot pop-up)
ai_auto_trigger.enable,ai_model,ai_model_providerai_auto_trigger.system_instructions,threshold(default 50)ai_auto_trigger.default_messagesai_auto_trigger.url_rules[]—url,trigger_type(chat/call),duration,messageai_auto_trigger.agent_name,agent_photo
Call auto-trigger (auto-connect video)
call_auto_trigger.is_activated,display_time(default 15s)call_auto_trigger.auto_connect_video_file(FileModel ObjectId)call_auto_trigger.has_audio,enable_ringtonecall_auto_trigger.auto_connect_agent_name,auto_connect_messagecall_auto_trigger.call_background.background_color,background_imagecall_auto_trigger.text_color
AI config
ai_config.chat_model,chat_model_providerai_config.call_model,call_agent_voice_idai_config.call_routing(ai / human / ai_to_human / hybrid)ai_config.chat_routing(ai / human / ai_to_human)enable_calling_agent
Routing & queues
chat_queue— bool, enable chat queueingallow_twilio_calls,always_twilio_calls
Knowledge base (for AI agents)
agent_knowledge_base_documents[]—file(FileModel),status,job_id,page_count,error,frontmatter
Page rules / widget rules
widget_page_rules.is_enable,rules[],hide_on_pages[]rules[].video_has_audio(Boolean, 2026-09) — whether the rule's media has a soundtrack; the widget hides its mute button when false (an uploaded image is converted to a silent MP4). Unset on older rules: the widget falls back towidgetvideo_audiowhen the rule reuses the company'svideo_file, otherwisetrue(rules used to accept video only).
White-label
widget_whitelabel.is_enable,text,url- Agency-managed:
agency_id,agency_self_account
Lead scoring
companies.lead_score:
visited_heigh_intent_page,user_initiated_callcall_auto_connect_accepted,chat_auto_connect_acceptedcall_greater_than,chat_greater_thanbooked_meeting,shared_email,shared_phoneindustry_match,product_searchedreturned_visitor(weight 50)pages_visited_exceeded(weight 50),pages_visited_threshold(default 3)notification_sent
Lead intelligence / B2B enrichment
lead_intelligence(master),lead_intelligence_allowed(default 40)rb2b_enabled,rb2b_allowed(default 20)snitcher_enabled,snitcher_allowed(default 20)allow_clearbitclearbit_contact_ghl.enable,synced_athappier_leads_config—website_id,client_id,private_key
Identity graph
identity_graph_allowed(super-admin gate)identity_graph_use_custom_configidentity_graph_config.enabled,enabled_sections[],custom_introidentity_graph_config.max_recent_pages / max_past_conversations / max_extracted_factsidentity_graph_config.verification_policy(permissive / moderate / strict / regulated)identity_graph_config.accept_inbound_call_verificationidentity_graph_config.capture_website_forms
See Identity Graph for what these control.
Knox (Nox admin assistant)
knox.enabled— default true, no UI writes it; scopes Nox background jobs only (Nox itself is on for every company)knox.target_marketknox.tracked_pages[],watchlist_companies[],high_value_pages[]knox.alert_thresholds.*—rage_click_spike_count,intent_score_floor,visit_count_alert,anomaly_std_dev,form_abandonment_rate_alert,dead_click_thresholdknox.digest_schedule.enabled,day,time_localknox.baseline_metrics(Mixed — nightly rollup of "what's normal")
See What is Nox and Daily Brief.
Notifications
notifications.chat_transcript,call,missed_callnotifications.reports_email.enabled,frequency,last_sent_atnotifications.daily_recap_email.enabled,last_sent_atnotifications.slack_new_visitor,slack_hot_leadsend_chat_transcript,chat_transcript_emails_to[]billing_emails[]
Integrations
hubspot.access_token / refresh_token / hub_id / scopes[]go_high_level.access_token / refresh_token / location_id / company_id / secret_key / calendar_id / booking_enabledghl_self_account— alternative GHL self-service flowcalendly_integration.access_token / refresh_token / owner_uri / event_type_uri / event_type_duration / scheduling_urlgoogle_calendar_integration.access_token / refresh_tokenzapier.secret,zapier.webhooks[](url, event, zap_id)webhooks_enabled
See CRM Integration.
Booking
booking_button— show the booking button in the widget
Billing
registered_package_id(Package ref)manual_ai_credits_calculation.credits_calculation,number_of_creditsstripe_customer_idfree_period_minutes(default 10)grace_period_claimedsignup_wallet_grant_pending/signup_wallet_granted_at— the one-time $10 direct-signup grant (Wallet)appsumo_license_key,appsumo_paused— AppSumo Licensing
Agency
agency_id(Agency ref)agency_self_account(bool) — the agency's own site; for self-serve agencies this is the signup's own business (Agency overview)created_via—'platform_api'when created by the agency's Platform API (shrinks/setupto password + auto-filled "Your business"); absent otherwiseindustry_details.agent_name/industry_details.default_description— also filled from the Platform API create call or the agency's client defaults
Super-admin gates
Still per-company: bot_flow_enabled (also fanned out per agency from agency.bot_flow_enabled), identity_graph_allowed, the
*_allowed limits, partner_certification_enabled, agent_k_lab_enabled,
agent_k_pacing_visible, agent_k_provider, snitcher_enabled,
gdpr_protection_enabled, and voice_engine_enabled — which since
70b732400 (2026-09-30) defaults to true for new companies (every
speech-to-speech provider allowed; a super admin can still turn it off).
Readers compare === true and lean() skips schema defaults, so an existing
company with no stored value still reads as off.
Removed 2026-09-25 (backend f1d39fb38, frontend 021eae6b, ms-ai
2f15c50f8) — fields, PUT /company/:_id/<toggle> routes, and every check
deleted; the feature is on for every company:
| Removed field | Old route | Now |
|---|---|---|
agent_k_beta_enabled | /agent-k-beta | ai_agent_k.enabled is the only switch; /company/agent-k/onboarding-enable is just client setup's wallet check (402 on an empty wallet) |
nox_activity_enabled | /nox-activity | Nox Activity for all (agency client permission pages.nox_activity still applies) |
nox_config_enabled | /nox-config | settings-by-chat for all |
verified_visitor_badge_enabled | /verified-visitor-badge | VerifiedVisitorBadge.vue renders on identity_trust === 'verified' alone |
widget_call_tags_enabled | /widget-call-tags | post-call tags whenever GHL is connected |
widget_chat_tags_enabled | /widget-chat-tags | post-chat tags whenever GHL is connected |
leadconnector_chat_start_url_enabled | /leadconnector-chat-start-url | CrmSyncHelper posts the "Chat started from" note for every GHL-connected company |
Removed 2026-10-09 (backend 1f9742dc8, frontend ac19403a): nox_funnel_beta_enabled and PUT /company/:_id/nox-funnel-beta — the tenant's nox_funnel.enabled is the only funnel switch (FunnelStageService.getConfig() returns null while it's off).
scripts/grandfather-agent-k-auto-push.js keeps its old beta filter on purpose.
Related
- Collections & tables — where
companiessits among all stores - Visitor data — the records visitor activity writes to
- What is Nox · Daily Brief
- Identity Graph · CRM Integration