Create BusinessSetting - Nexudus Platform

POST

api

sys

businesssettings

Create BusinessSetting

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/businesssettings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/businesssettings"

payload = {
    "BusinessId": 123,
    "Name": "<string>"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/businesssettings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

A BusinessSetting represents a single name/value configuration entry for a location. Each setting is identified by a dotted key (Name) and holds its value as a string (Value). Together, the collection of BusinessSetting records for a location forms the full configuration surface — covering billing, portal features, check-in behaviour, mobile apps, communications, security and more. Boolean settings store "True" or "False" as the value string. Numeric settings store the number as a string. Date settings store the date in ISO 8601 format. All other settings store plain text, HTML or Markdown as appropriate. To read a setting, list BusinessSettings filtered by location and Name. To change a setting, update the matching record’s Value.

Complete setting reference

Billing — Invoice details

Key	Type	Description
`Billing.BillToName`	text	Company / trading name shown on invoices
`Billing.BillToAddress`	text	Billing address shown on invoices
`Billing.BillToCity`	text	City shown on invoices
`Billing.BillToPostCode`	text	Zip / post code shown on invoices
`Billing.BillToState`	text	State / Province shown on invoices
`Billing.BillToCountry`	text	Country (entity ID) shown on invoices
`General.BusinessTaxIDNumber`	text	VAT / Tax ID number

Billing — Bank details

Key	Type	Description
`Billing.BankName`	text	Bank name included at text of invoices
`Billing.BankCode`	text	Bank code
`Billing.SortCode`	text	Sort code / routing number
`Billing.AccountNumber`	text	Account number

Billing — Payment notifications

Key	Type	Description
`Payments.NotifyOnInvoiceDefault`	bool	Enable notifications about new invoices for customers registered from now on
`Payments.NotifyOnNewPaymentDefault`	bool	Enable notifications about successful payments for customers registered from now on
`Payments.NotifyOnFailedPaymentDefault`	bool	Enable notifications about failed payments for customers registered from now on
`Payments.SuccessNotificationsEmail`	text	Email address to send a copy of every successful payment notification to
`Payments.FailureNotificationsEmail`	text	Email address to send a copy of every failed payment notification to

Billing — Invoice contents

Key	Type	Description
`Billing.CreateZeroValueInvoices`	bool	Create invoices even when total is zero
`Billing.UsePeriodAsInvoiceDate`	bool	Use the contract billing period start date as the invoice issue date
`Billing.InvoicesIncludeProductNotes`	bool	Include product sale notes in invoice lines
`Billing.InvoicesIncludeExtraServiceNotes`	bool	Include time-credit sale notes in invoice lines
`Billing.InvoicesIncludeBookingNotes`	bool	Include booking notes in invoice lines
`Billing.InvoicesIncludeTimePassNotes`	bool	Include pass sale notes in invoice lines
`Billing.InvoicesIncludeFullyCreditedBookings`	bool	Include lines for bookings fully paid by credit

Billing — Invoice split

Key	Type	Description
`Payments.CreateAnInvoicePerSpace`	bool	Create an invoice per location based on transactions
`Billing.SegregateContracts`	bool	Create an invoice per contract if a customer renews more than one
`Payments.CreateAnInvoicePerPurchaseOrder`	bool	Create an invoice per purchase order reference
`Billing.InvoiceSegregation.UsePreviousDay`	bool	Set secondary invoice date to one day earlier than primary
`Billing.SegregateBookings`	bool	Move bookings to secondary invoice
`Billing.SegregateProducts`	bool	Move products to secondary invoice
`Billing.SegregateTimePasses`	bool	Move passes to secondary invoice
`Billing.SegregateTickets`	bool	Move event tickets to secondary invoice
`Billing.SegregateCharges`	bool	Move charges to secondary invoice

Billing — Invoice formatting

Key	Type	Description
`Billing.InvoiceFormat.Sales`	text	Invoice reference format pattern. Use {1:0000} for sequential number, {0} for location reference, {year}/{month}/{day} for date parts
`Billing.InvoiceFormat.Draft`	text	Invoice draft reference format pattern
`Billing.InvoiceFormat.SeparateCreditNotes`	bool	Use a different number sequence for credit notes
`Billing.InvoiceFormat.CreditNote`	text	Credit note reference format pattern
`Payments.PaymentReferenceGenerator`	text	Payment reference format (ePaymentReferenceGeneratorType enum value)

Billing — Amount rounding

Key	Type	Description
`Billing.Rounding.Enable`	bool	Enable amount rounding
`Billing.Rounding.Line.DecimalPoints`	number	Decimal places for rounding each invoice line
`Billing.Rounding.DecimalPoints`	number	Decimal places for rounding invoice totals

Billing — Locked period

Key	Type	Description
`Billing.LockDates`	date	Lock invoices and payments made before this date

Billing — Tax

Key	Type	Description
`Billing.AddTaxToInvoices`	bool	Add tax to invoices
`Billing.RequireTaxRate`	bool	Require all sales to have a defined tax rate
`Billing.PricesIncludeTax`	bool	Prices typed in the back-end include tax
`Billing.DisplayTaxOnWebsite`	bool	Display prices including tax on website, app and emails
`Billing.TaxValue`	text	Default tax rate (entity ID of the tax rate record)

Billing — Financial accounts

Key	Type	Description
`Billing.RequireFinancialAccount`	bool	Require all sales to have a financial account

Billing — Proposals

Key	Type	Description
`Billing.DoNotIssueInvoice`	bool	Leave contracts issued by proposals as paused — do not issue invoices

Payments & Currency

Key	Type	Description
`Payments.Currency`	text	Secondary currency (entity ID) — payments processed in this currency
`Payments.ExchangeRate`	number	Exchange rate from primary to secondary currency
`Payments.RemindToPayEvery`	number	Number of days between payment reminders

Checkout — Plans

Key	Type	Description
`Forms.Enquiries.Enabled`	bool	Allow customers to enquire about plans
`Forms.Enquiries.Tour.Enabled`	bool	Include a tour as part of the enquiry
`Forms.Enquiries.TariffIds.OnlyEnquire`	bool	Prevent selected plans from being purchased directly

Checkout — Products

Key	Type	Description
`Store.AlwaysInvoice`	bool	Always invoice products immediately when purchased

Checkout — Bookings

Key	Type	Description
`Bookings.CancelUnPaidBookingsForNonSubscribers`	bool	Require up-front payment for bookings made by contacts
`Bookings.CancelUnPaidBookingsForSubscribers`	bool	Require up-front payment for bookings made by members
`Bookings.AutoPayContactBookings`	bool	Invoice and collect payment for contact bookings as they end
`Bookings.AutoPayMemberBookings`	bool	Invoice and collect payment for member bookings as they end
`Bookings.ChargeBookingsImmediately`	bool	Calculate price and use credit immediately when booking is requested
`Bookings.RequestDrafts`	bool	Allow customers to request a quote instead of confirming

Checkout — Event tickets

Key	Type	Description
`Events.CanCancelTickets`	bool	Allow customers to cancel event tickets
`Events.CancelUnpaidTickets`	bool	Automatically cancel unpaid tickets purchased by contacts
`Events.InvoiceAttendee`	bool	Invoice the event buyer instead of their team paying customer

Bookings — General

Key	Type	Description
`Bookings.EnableGuestBookings`	bool	Allow new customers to register and book from calendar
`Bookings.DoNotCreateGuestAccount`	bool	Do not create account for guest bookers (reversed: False = create account)
`Bookings.RegisterConactBookersAsVisitors`	bool	Register all contacts as visitors when they book
`Bookings.DoNotRegisterKnownCustomersAsVisitors`	bool	Do not register known customers as visitors when added as attendees (reversed)
`Bookings.CancelIfNotChekedIn`	bool	Require attendees to check in using NexBoard and cancel no-shows
`Bookings.RequireConfirmation.Members`	bool	Bookings made by members must be confirmed first
`Bookings.RequireConfirmation.Contacts`	bool	Bookings made by contacts must be confirmed first

Bookings — Notifications

Key	Type	Description
`Bookings.SendConfirmationEmail`	bool	Send booking confirmation email to customer
`Bookings.SendConfirmationToVisitors`	bool	Send booking confirmation to every guest added to a booking
`Bookings.SendReminderEmail`	bool	Send booking reminder email before booking begins
`Bookings.ReminderEmailMinutes`	number	Minutes before each booking to send reminder
`Bookings.SendAccessCode`	bool	Include Internet Access Token in booking emails

Bookings — Charges & payments

Key	Type	Description
`Bookings.PaidBookingsCancellationPolicy`	text	Cancellation policy for invoiced bookings (ePaidBookingsCancellationPolicy enum value)
`Bookings.UseCreditToPayBookingProducts`	bool	Use available credit to pay for products added to bookings
`Bookings.RejectIfNoCreditIsAvailable`	bool	Reject bookings if customers do not have enough credit
`Bookings.DueDateIgnoreProducts`	bool	Ignore recurrent products when calculating booking due dates

Bookings — Calendar

Key	Type	Description
`Calendars.ShowMemberDetailsInFeed`	bool	Show customer names and company in calendar
`Calendars.IncludeEventsInCalendar`	bool	Include events connected to a resource in calendar
`Calendars.IncludeEventsInFeed`	bool	Include events in calendar iCal feed
`PublicWebSite.ShowAllBookings`	bool	Show bookings from all users in calendar
`Members.ViewTeamBookings`	bool	Show bookings made by team members on home page
`Calendars.IncludeLinkedResources`	bool	Show combined resources as booked in calendar
`Bookings.ShowEndDate`	bool	Let users book across different days
`Bookings.AcceptPastBookings`	bool	Accept bookings in the past
`Bookings.IncludeBookingCreditInPrice`	bool	Consider money credit when showing booking prices
`Calendars.DefaultView`	text	Default calendar view (eCalendarDefaultView enum value)
`Bookings.DefaultBookingLength`	text	Default booking length
`Bookings.IntervalLimit`	text	Time picker interval

Bookings — Dynamic pricing

Key	Type	Description
`Nexudus.ML.ApplyFrom`	date	Apply dynamic pricing only to bookings made from this date

Bookings — Teams & attendance

Key	Type	Description
`Bookings.AttendanceBookingReminders.Enabled`	bool	Send office attendance reminders
`Bookings.AttendanceReport.Enabled`	bool	Send weekly attendance report to team administrators
`Members.AllowRemoveTeamMembers`	bool	Team administrators can remove members from teams
`Forms.TeamAdminsCanUpdateCards`	bool	Team administrators can update access card details

Check-in — General

Key	Type	Description
`Members.NotifyOnLowCredit`	bool	Notify users when running low on access time
`Members.NotifyOnLowCreditHours`	number	Notify when less than this many hours of credit remain
`Members.NotifyOnAutoCheckout`	bool	Notify users when they are automatically checked out
`Checkin.AlwaysRecordByMinute`	bool	Record multiple check-ins on the same calendar day
`Checkin.DailyCutOffTime`	text	Daily cut-off time for check-in
`MobileApp.NexClicker.MaxCapacity`	number	Building capacity (people)

Check-in — Pay as you go

Key	Type	Description
`Checkin.PayAsYouGo`	bool	Enable pay-as-you-go access
`Checkin.DiscountBookings`	bool	Exclude time used in bookings from check-in duration
`Checkin.PayAsYouGoMembersPayWithContract`	bool	Members pay pay-as-you-go charges via their contract
`Checkin.PayAsYouGoMinPrice`	number	Minimum daily price
`Checkin.PayAsYouGoMaxPrice`	number	Maximum daily price

Check-in — Network & devices

Key	Type	Description
`Security.DisableAutoChecking`	bool	Disable auto check-in via MAC address (reversed: False = auto check-in enabled)
`PublicWebSite.Visitors.CreateAccessTokns`	bool	Generate an access token for every pre-registered visitor
`PublicWebSite.Visitors.CreateAccessTokns.DefaultDuration`	number	Default duration in minutes for visitor access tokens
`Checkin.DeviceCountLimit`	number	Maximum number of devices per user
`PublicWebSite.Visitors.CreateAccessTokns.MaximumDevicesVisitor`	number	Maximum number of devices per visitor

Key	Type	Description
`Members.CanSignup`	bool	Allow customers to sign up online
`Members.SendWelcomeEmail`	bool	Send welcome email with access details to new users
`Members.UseInvitationLink`	bool	Restrict sign-ups to invite only
`Signup.UseCaptcha`	bool	Protect sign-up with Google Captcha
`Signup.AskForPassword`	bool	Let customers create their own password at sign-up
`Signup.ShowStoreOnSignUp`	bool	Offer additional products during sign-up
`Signup.KeepNewAccountsOnHold`	bool	Keep new customer accounts suspended by default
`Signup.MemberMustChooseAPricePlan`	bool	Suspend new accounts that do not complete payment
`Signup.GooglePlusSignUp`	bool	Allow sign-up with Google
`Signup.GooglePlusSignIn`	bool	Allow sign-in with Google
`Security.AutoRegister`	bool	Automatically register existing customers at new locations
`Security.AllowPasswordReset`	bool	Let users change their password
`Security.AutoGeneratePincode`	bool	Auto-generate 5-digit access pin-codes
`Security.GenerateUniquePincode`	bool	Require pin-codes to be unique across all customers

New customer access defaults

Key	Type	Description
`Access.Defaults.Network`	bool	New customers have access to IT network by default
`Access.Defaults.Bookings`	bool	New customers can make bookings by default
`Access.Defaults.Products`	bool	New customers can purchase products by default
`Access.Defaults.Events`	bool	New customers can purchase events by default
`Access.Defaults.Community`	bool	New customers can use discussion boards by default

Key	Type	Description
`SignupForm.LandLine`	text	Phone field requirement (eFormFieldStatus value)
`SignupForm.MobilePhone`	text	Mobile / Cell field requirement (eFormFieldStatus value)
`SignupForm.Gender`	text	Gender field requirement (eFormFieldStatus value)
`SignupForm.DateOfBirth`	text	Date of birth field requirement (eFormFieldStatus value)
`SignupForm.ShowContactSection`	bool	Show contact details section in sign-up and profile forms
`SignupForm.ShowBillingSection`	bool	Show billing details section in sign-up and profile forms
`SignupForm.ShowProfileSection`	bool	Show profile details section in sign-up form
`SignupForm.Avatar`	text	Photo profile field requirement (eFormFieldStatus value)

Forms — Contact details fields

Key	Type	Description
`Forms.Address`	text	Address form field requirement (eFormFieldStatus value)
`Forms.CityName`	text	City form field requirement (eFormFieldStatus value)
`Forms.State`	text	State form field requirement (eFormFieldStatus value)
`Forms.PostCode`	text	Postcode / zip form field requirement (eFormFieldStatus value)
`Forms.Country`	text	Country form field requirement (eFormFieldStatus value)

Forms — Billing details fields

Key	Type	Description
`Forms.BillingName`	text	Company name billing field requirement (eFormFieldStatus value)
`Forms.TaxIDNumber`	text	Tax / Company ID billing field requirement (eFormFieldStatus value)
`Forms.BillingAddress`	text	Address billing field requirement (eFormFieldStatus value)
`Forms.BillingCityName`	text	City billing field requirement (eFormFieldStatus value)
`Forms.BillingState`	text	State billing field requirement (eFormFieldStatus value)
`Forms.BillingPostCode`	text	Postcode / zip billing field requirement (eFormFieldStatus value)
`Forms.BillingEmail`	text	Billing email field requirement (eFormFieldStatus value)
`Forms.BillingCountry`	text	Billing country field requirement (eFormFieldStatus value)

Forms — Profile fields

Key	Type	Description
`Forms.CompanyName`	text	Company name profile field requirement (eFormFieldStatus value)
`Forms.BusinessArea`	text	Industry profile field requirement (eFormFieldStatus value)
`Forms.Position`	text	Position profile field requirement (eFormFieldStatus value)
`Forms.ProfileSummary`	text	Profile bio field requirement (eFormFieldStatus value)
`Forms.PorfileTags`	text	Skills profile field requirement (eFormFieldStatus value)
`Forms.ProfileWebiste`	text	Website profile field requirement (eFormFieldStatus value)

Legal terms & policies

Key	Type	Description
`Legal.VisitorTermsAndConditions`	markdown	Visitor terms and conditions shown during NexIO registration
`Legal.CheckoutTermsAndConditions`	markdown	Checkout terms shown before booking or payment
`Legal.Privacy`	markdown	Privacy policy linked in portal footer
`Legal.Cookies`	markdown	Cookies policy linked in portal footer and login page

Portal — Appearance & version

Key	Type	Description
`Nexudus.NextJS.Version`	text	Members Portal version
`PublicWebSite.IncludeInLocationSelector`	bool	Display this location in website and app location selector
`PublicWebSite.ShowOnlyRegisteredWithLocations`	bool	List only locations customers are registered with

Portal — Features

Key	Type	Description
`PublicWebSite.MyAccount`	bool	Enable My Account section
`PublicWebSite.Help`	bool	Enable help-desk section
`PublicWebSite.Deliveries`	bool	Enable deliveries section
`PublicWebSite.Contact`	bool	Enable contact form
`PublicWebSite.CommunityBoard`	bool	Enable discussion boards section
`PublicWebSite.Events`	bool	Enable events and tickets section
`Members.PublicDirectory`	bool	Enable directory section
`Blog.Enabled`	bool	Enable articles section
`PublicWebSite.Attendance`	bool	Enable team attendance section
`PublicWebSite.Visitors`	bool	Enable visitor registration section
`PublicWebSite.Tour`	bool	Enable tour request form
`PublicWebSite.Metrics`	bool	Enable metrics section
`PublicWebSite.Notifications`	bool	Enable notifications section

Portal — Home page

Key	Type	Description
`PublicWebSite.Home.UseCommunityDashboard`	bool	Show community feed when customers log in
`HomePage.Banner`	bool	Show rotating banner on home page
`HomePage.ShowIconBar`	bool	Show shortcuts to commonly used sections
`HomePage.ShowClaimBar`	bool	Show primary claim text
`HomePage.ShowServicesBar`	bool	Show offered services section
`HomePage.ShowFooterClaimBar`	bool	Show secondary claim text
`HomePage.ShowCheckedInMembers`	bool	Show list of checked-in customers
`HomePage.NewsletterSignUp`	bool	Show newsletter sign-up section

Key	Type	Description
`HomePage.BannerText`	text	Banner main text
`HomePage.BannerSmallText`	text	Banner secondary text

Portal — Shortcuts

Key	Type	Description
`HomePage.AboutUsIcon`	bool	Show shortcut to about us
`HomePage.EventsIcon`	bool	Show shortcut to events
`HomePage.DirectoryIcon`	bool	Show shortcut to directory
`HomePage.BookingsIcon`	bool	Show shortcut to bookings calendar
`HomePage.MyAccountIcon`	bool	Show shortcut to my account or sign-up

Portal — Primary claim

Key	Type	Description
`HomePage.ClaimText`	text	Primary claim main text
`HomePage.ClaimSmallTextLogout`	text	Primary claim secondary text for logged-out users
`HomePage.ClaimSmallTextLogin`	text	Primary claim secondary text for logged-in users

Portal — Service tiles

Key	Type	Description
`HomePage.ShowWorkspaceService`	bool	Show workspace tile
`HomePage.WorkSpaceShortText`	text	Workspace tile heading
`HomePage.WorkSpaceLongText`	text	Workspace tile description
`HomePage.ShowBookingsService`	bool	Show bookings tile
`HomePage.BookingsShortText`	text	Bookings tile heading
`HomePage.BookingsLongText`	text	Bookings tile description
`HomePage.ShowCommunityService`	bool	Show community tile
`HomePage.CommunityShortText`	text	Community tile heading
`HomePage.CommunityLongText`	text	Community tile description
`HomePage.ShowChildCareService`	bool	Show child care tile
`HomePage.ChildCareShortText`	text	Child care tile heading
`HomePage.ChildCareLongText`	text	Child care tile description
`HomePage.ShowBenefitsService`	bool	Show benefits tile
`HomePage.BenefitsShortText`	text	Benefits tile heading
`HomePage.BenefitsLongText`	text	Benefits tile description
`HomePage.ShowEventsService`	bool	Show events tile
`HomePage.EventsShortText`	text	Events tile heading
`HomePage.EventsLongText`	text	Events tile description

Key	Type	Description
`HomePage.FooterClaimText`	text	Secondary claim main text
`Footer.SayingText`	text	Footer saying text
`Footer.SayingAuthor`	text	Footer saying author

Key	Type	Description
`Social.Twitter`	text	X (Twitter) handle
`Social.Flickr`	text	Flickr URL
`Social.Facebook`	text	Facebook URL
`Social.Instagram`	text	Instagram handle

Portal — Access to sections

These settings control who can see each section of the members portal. Values are integers from the ePublicWebsiteAccess enum: 1 = Everyone, 2 = Logged-in users, 3 = Only members, 4 = Only contacts.

Key	Type	Description
`Access.Global`	int (1–4)	Access level for entire portal
`Access.HomePage`	int (1–4)	Access level for home page
`Access.AboutUs`	int (1–4)	Access level for about us page
`Access.Help`	int (1–4)	Access level for help-desk module
`Access.Events`	int (1–4)	Access level for events list and calendar
`Access.Bookings`	int (1–4)	Access level for booking pages
`Access.Directory`	int (1–4)	Access level for directory pages
`Access.CommunityBoard`	int (1–4)	Access level for discussion board pages
`Access.Blog`	int (1–4)	Access level for blog and article pages
`Access.Contact`	int (1–4)	Access level for contact pages
`Access.Account.Payments`	int (1–4)	Access level for payments page
`Access.Account.PricePlans`	int (1–4)	Access level for plan selection page
`Access.Account.Allowances`	int (1–4)	Access level for benefits page
`Access.Account.Store`	int (1–4)	Access level for products store page
`Access.Discounts`	int (1–4)	Access level for perks and benefits page
`Access.FAQs`	int (1–4)	Access level for FAQ pages

Portal — Data visibility

Key	Type	Description
`Access.Data.Events`	text	Events visibility scope (eDataVisibilityCriteria enum value)
`Access.Data.Blog`	text	Articles visibility scope
`Access.Data.Perks`	text	Perks and discounts visibility scope
`Access.Data.FAQs`	text	FAQ articles visibility scope
`Access.Data.Resources`	text	Bookable resources visibility scope
`Access.Data.Products`	text	Products visibility scope

My Account features

Key	Type	Description
`Members.AllowTariffChange`	bool	Users can change or cancel their plan
`Members.AllowBookings`	bool	Users can request new bookings
`Members.AllowChangeBookings`	bool	Users can change existing bookings
`Members.AllowHelpMessages`	bool	Users can submit help-desk requests
`Members.ViewInvoices`	bool	Users can view and pay invoices
`Members.PrintInvoices`	bool	Users can print invoices

Discussion boards

Key	Type	Description
`PublicWebSite.CommunityBoard.GroupsOnly`	bool	Customers can only post to groups they have access to
`Digest.AutoSignUpMembers`	bool	Sign up new users to daily digest
`Digest.SendToMembers`	bool	Enable digest notifications to members
`Digest.SendToContacts`	bool	Enable digest notifications to contacts
`Digest.SubjectFormat`	text	Digest email subject line format

Articles

Key	Type	Description
`Blog.AllowComments`	bool	Let users post comments on articles
`Blog.AutoPublishComments`	bool	Automatically publish comments on articles

Events

Key	Type	Description
`Events.SendAccessCode`	bool	Include internet access code in event tickets
`Events.SendReminders`	bool	Send 24-hour reminder before events

Key	Type	Description
`Newsletter.AutoSignUpMembers`	bool	Add every new customer as subscriber
`Newsletter.DefaultOptIn`	bool	Newsletter subscribers active by default

Key	Type	Description
`Directory.OnlyInvoicingSpace`	bool	List only invoicing-location customers (reversed: False = list all locations)
`Directory.DirectoryRecords`	text	Directory record types (eDirectoryRecordType enum value)
`Directory.DirectoryContents`	text	Directory contents type (eDirectoryContents enum value)
`Directory.ProfileTags`	text	Profile skills and industries

Tours

Key	Type	Description
`PublicWebSite.Tour.RequiresConfirmation`	bool	Tour requests must be confirmed by an administrator
`PublicWebSite.Tour.TimeSlots.Enabled`	bool	Tours can only be booked at specific hours/days
`PublicWebSite.Tour.TimeSlots`	text	Tour time slots configuration
`PublicWebSite.Tour.Host`	text	Tour host user (entity ID)

About us

Key	Type	Description
`PublicWebSite.AboutUs`	bool	Enable About Us module

Space dashboard

Key	Type	Description
`Dashboard.Enabled`	bool	Enable space dashboard

Communications — Email

Key	Type	Description
`Email.Disable`	bool	Disable notifications system (reversed: False = enabled)
`Email.FromName`	text	From name on outgoing emails
`Email.FromEmail`	text	Reply-to email address
`Email.CCEmail`	text	CC email address
`Email.CCOEmail`	text	BCC email address
`Email.CCO`	bool	BCC the reply-to email on all outgoing emails
`Email.UseDefaultSettings`	bool	Use Nexudus servers to deliver email
`Email.ServerName`	text	Custom SMTP server host
`Email.SMTPPort`	number	Custom SMTP server port
`Email.UseSSL`	bool	Connect to SMTP using SSL
`Email.ServerUsername`	text	SMTP username
`Email.ServerPassword`	text	SMTP password

Security & access

Key	Type	Description
`Access.TwoFactor.Enforce`	bool	Enforce Two Factor Authentication for admin users
`Access.TwoFactor.EnforceFromDate`	date	Enforce 2FA from this date
`Security.Crm.EnforceOpportunityOwnership`	bool	Only admins or owner can change CRM opportunities
`Nexudus.Oauth.AccessTokenExpireTimeSpan`	text	Admin session timeout
`PublicWebsite.AllowedDomains`	text	Authorized redirect domains

Nexudus subscription

Key	Type	Description
`Nexudus.SupportUrl`	text	Dedicated Support Agent URL
`Nexudus.TrialDays`	number	Trial period in days

Mobile app — Passport features

Key	Type	Description
`MobileApp.DisplayHomeVertically`	bool	Display home sections vertically
`MobileApp.Feed`	bool	Enable Discussion boards section
`MobileApp.Directory`	bool	Enable directory section
`MobileApp.Bookings`	bool	Enable bookings and floor plans
`MobileApp.Events`	bool	Enable events and tickets
`MobileApp.Blog`	bool	Enable articles section
`MobileApp.Me`	bool	Enable my account section
`MobileApp.LocationServices`	bool	Enable location services
`MobileApp.FeedPrivate`	bool	Enable private messages
`MobileApp.Help`	bool	Enable help-desk section
`Google.Analytics.v4.Mobile`	bool	Enable Google Analytics 4

Mobile app — Passport home page

Key	Type	Description
`MobileApp.Home.CheckedInMembers`	bool	Show checked-in customer count
`MobileApp.Home.OngoingBookings`	bool	Show ongoing bookings
`MobileApp.Home.UpcomingBookings`	bool	Show upcoming bookings
`MobileApp.Home.Blog`	bool	Show articles
`MobileApp.Home.Events`	bool	Show events
`MobileApp.Home.Benefits`	bool	Show customer credits and benefits
`MobileApp.Home.Invoices`	bool	Show unpaid invoices
`MobileApp.Home.Deliveries`	bool	Show uncollected deliveries
`MobileApp.Home.Elatec`	bool	Show print release (Elatec)
`MobileApp.Home.CommunityBoard`	bool	Show discussion boards
`MobileApp.Home.Visitors`	bool	Show upcoming visitors
`MobileApp.Home.AccessControl`	bool	Show access control section
`MobileApp.Home.QRCode`	bool	Show customer QR code

Mobile app — Passport white-label

Key	Type	Description
`MobileApp.PrimaryColor`	text	Primary colour
`MobileApp.SecondaryColor`	text	Secondary colour
`MobileApp.TertiaryColor`	text	Tertiary colour
`MobileApp.FontFamily`	text	Font family (eAppFontName enum value)

Mobile app — Passport access control

Key	Type	Description
`MobileApp.Access.Enabled`	bool	Enable access control page in app
`MobileApp.Access.Url`	text	Access control page URL

Mobile app — Passport custom page

Key	Type	Description
`MobileApp.CustomPage.Enabled`	bool	Enable custom page in app
`MobileApp.CustomPage.Title`	text	Custom page title
`MobileApp.CustomPage.Url`	text	Custom page URL
`MobileApp.CustomPage.ShowOnHomePage`	bool	Show custom page on app home page
`MobileApp.CustomPage.Secret`	text	Custom page shared secret

Mobile app — Push notifications

Key	Type	Description
`OneSignal.AppKey`	text	OneSignal App Id
`OneSignal.RestKey`	text	OneSignal REST Key

Mobile app — App download URLs

Key	Type	Description
`MobileApp.iOS.Url`	text	iOS app download URL
`MobileApp.Android.Url`	text	Android app download URL

Mobile app — Automation tiles & deep links

Key	Type	Description
`MobileApp.iOS.TeamId`	text	iOS team id
`MobileApp.iOS.BundleId`	text	iOS bundle id
`MobileApp.Android.PackageName`	text	Android package name
`MobileApp.Android.CertFingerprint`	text	Android certificate fingerprint
`AutomationTiles.SharedSecret`	text	Automation tiles shared secret

NexIO — Visitor check-in

Key	Type	Description
`MobileApp.FrontDesk.Version`	text	NexIO version
`MobileApp.FrontDesk.Checkin.Fields.Email`	bool	Ask for visitor email
`MobileApp.FrontDesk.Checkin.RequireEmail`	bool	Make visitor email required
`MobileApp.FrontDesk.Checkin.Fields.Member`	bool	Ask visitor to choose a customer as host
`MobileApp.FrontDesk.Checkin.RequireMember`	bool	Require visitor to choose a host
`MobileApp.FrontDesk.Checkin.Fields.PhoneNumber`	bool	Ask for visitor phone number
`MobileApp.FrontDesk.Checkin.Fields.PhoneNumber.Required`	bool	Visitor phone number is required
`MobileApp.FrontDesk.Checkin.Fields.CompanyName`	bool	Ask for visitor company name
`MobileApp.FrontDesk.Checkin.Fields.Reason`	bool	Ask for reason for visit
`MobileApp.FrontDesk.Checkin.ShowNewsletter`	bool	Show newsletter opt-in check-box
`MobileApp.FrontDesk.Checkin.CustomerFilter`	text	Customer selection menu filters

NexIO — Language / messages

Key	Type	Description
`MobileApp.FrontDesk.Checkin.WelcomeMessage`	text	Welcome message
`MobileApp.FrontDesk.Checkin.HomeMessage`	text	Home message
`MobileApp.FrontDesk.Checkin.TapToStartMessage`	text	Tap to start message
`MobileApp.FrontDesk.Checkin.IamVisitorMessage`	text	I am a visitor message
`MobileApp.FrontDesk.Checkin.IamAMemberMessage`	text	I am a member message
`MobileApp.FrontDesk.Checkin.DoYouHaveVisitorCodeMessage`	text	Do you have a code message
`MobileApp.FrontDesk.Checkin.WelcomeTitle`	text	Welcome title after check-in
`MobileApp.FrontDesk.Checkin.WelcomeVisitor`	text	Welcome text for visitors
`MobileApp.FrontDesk.Checkin.WelcomeEvent`	text	Welcome text for event attendees
`MobileApp.FrontDesk.Checkin.WelcomeMember`	text	Welcome text for customers
`MobileApp.FrontDesk.Checkin.ByeByeTitle`	text	Goodbye title after check-out
`MobileApp.FrontDesk.Checkin.ByeByeMessage`	text	Goodbye message after check-out

NexBoard

Key	Type	Description
`MobileApp.NexBoard.ShowLastCleaned`	bool	Show when the resource was last cleaned

NexEvents

Key	Type	Description
`MobileApp.NexBoard.Checkin.QRCodes`	bool	Include QR code in attendee confirmation email

NexDelivery

Key	Type	Description
`MobileApp.FrontDesk.Delivery.HideSignatureScreen`	bool	Hide collection signature screens (reversed: False = shown)
`MobileApp.FrontDesk.Delivery.HidePrintButton`	bool	Hide delivery label print button (reversed: False = shown)

NexKIOSK

Key	Type	Description
`NexKiosk.Enabled`	bool	Enable NexKIOSK
`NexKiosk.QuickSale.Enabled`	bool	Enable Quick Sale mode
`NexKiosk.QuickSale.CoworkerId`	text	Customer for Quick Sale invoices (entity ID)
`NexKiosk.ShowAllInvoices`	bool	Show all invoices, including those created outside NexKiosk
`NexKiosk.POS.Payments.Enabled`	bool	Show payment add/refund buttons
`NexKiosk.POS.CoworkerType`	text	Customer type filter for POS (eCoworkerType enum value)
`NexKiosk.KIOSK.Discounts.Enabled`	bool	Allow discounts in Kiosk mode
`NexKiosk.DisableAddToBill`	bool	Disable add-to-bill for customers (reversed: False = allowed)
`NexKiosk.StripeLocationId`	text	Stripe Location Id

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the BusinessSetting-Create role.

Request Body

Required Fields

integer

required

ID of the business linked to this record.

string

required

Dotted setting key that identifies this configuration entry (e.g. Billing.AddTaxToInvoices, Bookings.SendConfirmationEmail).

Optional Fields

string

Setting value stored as a string. Boolean settings use True/False, numeric settings use the number as text, dates use ISO 8601 format.

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/sys/businesssettings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": ""
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/sys/businesssettings',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: ''
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/sys/businesssettings',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': ''
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the creation.

object

Contains the Id of the newly created record.

boolean

true if the businesssetting was created successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "BusinessSetting was successfully created.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}

Update BusinessSettingUpdate an existing BusinessSetting record.

Create BusinessSetting

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/businesssettings \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/businesssettings"

payload = {
    "BusinessId": 123,
    "Name": "<string>"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>'})
};

fetch('https://spaces.nexudus.com/api/sys/businesssettings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

​Complete setting reference

​Billing — Invoice details

​Billing — Bank details

​Billing — Payment notifications

​Billing — Invoice contents

​Billing — Invoice split

​Billing — Invoice formatting

​Billing — Amount rounding

​Billing — Locked period

​Billing — Tax

​Billing — Financial accounts

​Billing — Proposals

​Payments & Currency

​Checkout — Plans

​Checkout — Products

​Checkout — Bookings

​Checkout — Event tickets

​Bookings — General

​Bookings — Notifications

​Bookings — Charges & payments

​Bookings — Calendar

​Bookings — Dynamic pricing

​Bookings — Teams & attendance

​Check-in — General

​Check-in — Pay as you go

​Check-in — Network & devices

​Sign-up & registration

​New customer access defaults

​Forms — Sign-up personal details

​Forms — Contact details fields

​Forms — Billing details fields

​Forms — Profile fields

​Legal terms & policies

​Portal — Appearance & version

​Portal — Features

​Portal — Home page

​Portal — Banner

​Portal — Shortcuts

​Portal — Primary claim

​Portal — Service tiles

​Portal — Secondary claim & footer

​Portal — Social networks

​Portal — Access to sections

​Portal — Data visibility

​My Account features

​Discussion boards

​Articles

​Events

​Newsletter

​Directory

​Tours

​About us

​Space dashboard

​Communications — Email

​Security & access

​Nexudus subscription

​Mobile app — Passport features

​Mobile app — Passport home page

​Mobile app — Passport white-label

​Mobile app — Passport access control

​Mobile app — Passport custom page

​Mobile app — Push notifications

​Mobile app — App download URLs

​Mobile app — Automation tiles & deep links

​NexIO — Visitor check-in

​NexIO — Language / messages

​NexBoard

​NexEvents

​NexDelivery

​NexKIOSK

​Authentication

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Complete setting reference

Billing — Invoice details

Billing — Bank details

Billing — Payment notifications

Billing — Invoice contents

Billing — Invoice split

Billing — Invoice formatting

Billing — Amount rounding

Billing — Locked period

Billing — Tax

Billing — Financial accounts

Billing — Proposals

Payments & Currency

Checkout — Plans

Checkout — Products

Checkout — Bookings

Checkout — Event tickets

Bookings — General

Bookings — Notifications

Bookings — Charges & payments

Bookings — Calendar

Bookings — Dynamic pricing

Bookings — Teams & attendance

Check-in — General

Check-in — Pay as you go

Check-in — Network & devices

Sign-up & registration

New customer access defaults

Forms — Sign-up personal details

Forms — Contact details fields

Forms — Billing details fields

Forms — Profile fields

Legal terms & policies

Portal — Appearance & version

Portal — Features

Portal — Home page

Portal — Banner

Portal — Shortcuts

Portal — Primary claim

Portal — Service tiles

Portal — Secondary claim & footer

Portal — Social networks

Portal — Access to sections

Portal — Data visibility

My Account features

Discussion boards

Articles

Events

Newsletter

Directory

Tours

About us

Space dashboard

Communications — Email

Security & access

Nexudus subscription

Mobile app — Passport features

Mobile app — Passport home page

Mobile app — Passport white-label

Mobile app — Passport access control

Mobile app — Passport custom page

Mobile app — Push notifications

Mobile app — App download URLs

Mobile app — Automation tiles & deep links

NexIO — Visitor check-in

NexIO — Language / messages

NexBoard

NexEvents

NexDelivery

NexKIOSK

Authentication

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400