Update organisation settings

PUThttps://app.speybooks.com/api/v1/organisation/settings

Update operational settings. Three groups of fields are accepted, and the update is applied atomically:

VAT and accounting: currency (ISO 4217), vatRegistered, vatScheme (not_registered, standard, or flat_rate), vatFlatRatePercent, and fiscalYearStart in MM-DD format (for example "04-06" for 6 April, the UK tax year start).

Invoice defaults: invoicePrefix, invoiceNextNumber, invoiceDefaultTerms, invoiceDefaultNotes.

Quote defaults: quotePrefix, quoteNextNumber, quoteDefaultTerms, quoteDefaultNotes, quoteValidityDays.

Only the fields supplied are changed.

Body parameters

currencystringoptional
ISO 4217 currency code (e.g. GBP, EUR). 3 characters.
fiscalYearStartstringoptional
Fiscal year start as MM-DD (e.g. 04-06 for UK tax year).
invoiceDefaultNotesstringoptional
Default notes text for new invoices.
invoiceDefaultTermsstringoptional
Default payment terms text for new invoices.
invoiceNextNumberintegeroptional
Next invoice auto-number.
invoicePrefixstringoptional
Invoice number prefix (max 10 characters, e.g. INV).
quoteDefaultNotesstringoptional
Default notes text for new quotes.
quoteDefaultTermsstringoptional
Default terms text for new quotes.
quoteNextNumberintegeroptional
Next quote auto-number.
quotePrefixstringoptional
Quote number prefix (max 10 characters, e.g. QTE).
quoteValidityDaysintegeroptional
Default quote validity period in days (1-365).
vatFlatRatePercentnumberoptionalnullable
Flat rate VAT percentage (0-100). Only relevant when vatScheme is flat_rate.
vatRegisteredbooleanoptional
Whether the organisation is VAT registered.
vatSchemestringoptional
VAT accounting scheme.
not_registeredstandardflat_rate

Response

200Settings updated successfully.
Show response fields
updatedboolean

Error codes

400Validation error in settings data.