Batch update organizations

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}

Close
POST /api-v1/organization/batch

Updates multiple organizations. Returns 200 on success, or 400 if any entry fails validation.

Headers

  • WEAL-TOKEN Required

    API token (can be retrieved from account settings)

  • TARGET-ORGANIZATION-ID

    ID of organization, for which the operation must be performed

application/json

Body Required

  • id integer

    Standalone organization ID

  • name string Required

    Organization name

  • currency string Required

    ISO 4217 currency code

  • mainLanguage object Required

    Main language

    Hide mainLanguage attributes Show mainLanguage attributes object
    • id integer(int64)
    • code string
    • name string
    • isMain boolean
  • otherLanguages array[object]

    Additional languages

    Hide otherLanguages attributes Show otherLanguages attributes object
    • id integer(int64)
    • code string
    • name string
    • isMain boolean
  • parentStandaloneOrganizationId integer

    Parent organization ID

  • nogaCodeId integer

    NOGA economic activity code ID

  • startDate string Required

    Start date (format dd/MM/yyyy)

  • endDate string

    End date (format dd/MM/yyyy)

  • externalId string

    External identifier

  • archived boolean

    Whether the organization is archived

  • isFreeTier boolean

    Whether the organization is a free tier. Ignored if the current user is not an admin

  • isConsolidated boolean

    Whether the organization is consolidated

  • consolidatedOrganizationIds array[integer]

    IDs of consolidated child organizations. Only relevant when isConsolidated = true

  • stockStrategy string

    Stock valuation strategy

    Values are FIFO, LIFO, AVERAGE, UNIT, or TRADING.

  • vatSupplierContactId integer

    VAT supplier contact ID

  • useUnsentPayrollStatus boolean

    Whether to use the unsent payroll status

  • uid string

    UID / company registration number

  • automaticSynchronizationOfContacts boolean

    Whether contacts are automatically synchronized

  • auditorId integer

    Auditor contact ID

  • isFiduciary boolean

    Whether this is a fiduciary organization

  • banks array[object]

    Bank account for a contact

    Hide banks attributes Show banks attributes object

    Bank account for a contact

    • id integer

      Entity ID. If negative value, a new entity will be created

    • name string

      Bank account name / label

    • accountNumber string

      Account number / IBAN

    • qrIban string

      QR-IBAN

    • isrCustomerNumber string

      ISR customer number

    • bankCustomerNumber string

      Bank customer number

    • swiftBic string

      SWIFT / BIC code

    • bankName string

      Bank name

    • remark string

      Remark or note

    • position integer(int32)

      Position order

    • useForReconciliation boolean

      Whether this bank account is used for reconciliation

    • chartOfAccounts integer

      Chart of accounts ID linked to this bank account

    • accountHolderAddress object

      Custom account holder address. Should be specified only if customHolder is set to true.

      Hide accountHolderAddress attributes Show accountHolderAddress attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • name string

        Address label / name

      • line1 string

        Address line 1

      • line2 string

        Address line 2

      • city string

        City

      • region object

        Region

        Hide region attribute Show region attribute object
        • id integer

          Region ID

      • countryCode2 string

        ISO 3166-1 alpha-2 country code

      • countryId integer

        Country ID

      • postCode string

        Postal code

      • houseNumber string

        House number

      • toTheAttentionOf string

        To the attention of

      • position integer(int32)

        Position order

      • service string

        Service label

    • customHolder boolean

      Whether a custom account holder address is used

  • officeAddresses array[object]

    Office address of an organization

    Hide officeAddresses attributes Show officeAddresses attributes object

    Office address of an organization

    • id integer

      Entity ID. If negative value, a new entity will be created

    • name string

      Address label / name

    • line1 string

      Address line 1

    • line2 string

      Address line 2

    • city string

      City

    • region object

      Region

      Hide region attribute Show region attribute object
      • id integer

        Region ID

    • postCode string

      Postal code

    • toTheAttentionOf string

      To the attention of

    • position integer(int32)

      Position order

    • countryId integer

      Country ID

    • houseNumber string

      House number

    • service string

      Service label

    • dtbNumber string

      DTB number

    • cedNumber string

      CED number

    • fiduciaryId integer

      Fiduciary organization ID

    • inventoryLocation boolean

      Whether this address is an inventory/stock location

  • invoiceSettings object

    Invoice, order and timesheet settings

    Hide invoiceSettings attributes Show invoiceSettings attributes object
    • id integer

      Invoice settings ID

    • defaultPaymentTerms string

      Default payment terms in days

    • emailForInvoiceScans string

      Email address used to receive invoice scans

    • scansTreatedByManagingOrg boolean

      Whether invoice scans are treated by the managing organization

    • validatePurchaseInvoicesByDefaultType string

      Default validation behavior for purchase invoices

      Values are NONE, SINGLE, or DOUBLE.

    • usePurchaseAccrualAccounting boolean

      Whether to use purchase accrual accounting

    • skipDraftStatus boolean

      Whether to skip the draft status for purchase invoices

    • plannedPaymentDateOffset integer(int32)

      Planned payment date offset in days

    • purchasePaymentAccountId integer

      Default purchase payment chart of accounts ID

    • vatNumber string

      VAT number

    • requestedPaymentTerms string

      Requested payment terms for sales invoices in days

    • numbering string

      Invoice numbering pattern

    • timesheets boolean

      Whether timesheets are enabled at organization level

    • salesInvoiceConditionsLocalizations object

      Multilingual sales invoice conditions text

      Hide salesInvoiceConditionsLocalizations attributes Show salesInvoiceConditionsLocalizations attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • en string
      • fr string
      • de string
      • it string
    • useSalesAccrualAccounting boolean

      Whether to use sales accrual accounting

    • validateSalesInvoicesByDefaultType string

      Default validation behavior for sales invoices

      Values are NONE, SINGLE, or DOUBLE.

    • salesPaymentAccountId integer

      Default sales payment chart of accounts ID

    • useUnsentSalesStatus boolean

      Whether to use the unsent status for sales invoices

    • lateInvoiceRequestedPaymentTerms string

      Requested payment terms for late invoices

    • lateInvoiceConditionsLocalizations object

      Multilingual late invoice conditions text

      Hide lateInvoiceConditionsLocalizations attributes Show lateInvoiceConditionsLocalizations attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • en string
      • fr string
      • de string
      • it string
    • orderIdNumbering string

      Order ID numbering pattern

    • expenseAccountId integer

      Default expense chart of accounts ID

    • orderValidity string

      Default order validity in days

    • validateOrdersByDefaultType string

      Default validation behavior for orders

      Values are NONE, SINGLE, or DOUBLE.

    • timesheetsAccountId integer

      Default timesheets chart of accounts ID

    • disbursementAccountId integer

      Default disbursement chart of accounts ID

    • salesOrderTermsLocalizations object

      Multilingual sales order terms text

      Hide salesOrderTermsLocalizations attributes Show salesOrderTermsLocalizations attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • en string
      • fr string
      • de string
      • it string
    • useUnsentOrdersStatus boolean

      Whether to use the unsent status for orders

    • forceTreatedAsPi boolean

      Whether to force purchase invoices to be treated as PI

    • invoiceEmailContentSettings object

      Email content settings used when sending invoices

      Hide invoiceEmailContentSettings attributes Show invoiceEmailContentSettings attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • salesInvoiceEmailSubjectLocalizations object

        Multilingual sales invoice email subject

        Hide salesInvoiceEmailSubjectLocalizations attributes Show salesInvoiceEmailSubjectLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • salesInvoiceEmailContentLocalizations object

        Multilingual sales invoice email content

        Hide salesInvoiceEmailContentLocalizations attributes Show salesInvoiceEmailContentLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • customSalesInvoiceEmail boolean

        Whether a custom sales invoice email is used

      • lateNoticesEmailSubjectLocalizations object

        Multilingual late notice email subject

        Hide lateNoticesEmailSubjectLocalizations attributes Show lateNoticesEmailSubjectLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • lateNoticesEmailContentLocalizations object

        Multilingual late notice email content

        Hide lateNoticesEmailContentLocalizations attributes Show lateNoticesEmailContentLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • customLateNoticeEmail boolean

        Whether a custom late notice email is used

      • orderEmailSubjectLocalizations object

        Multilingual order email subject

        Hide orderEmailSubjectLocalizations attributes Show orderEmailSubjectLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • orderEmailContentLocalizations object

        Multilingual order email content

        Hide orderEmailContentLocalizations attributes Show orderEmailContentLocalizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • customSalesOrderEmail boolean

        Whether a custom sales order email is used

    • pdfInvoiceSplitterEnabled boolean

      Whether PDF invoice splitting is enabled

  • defaultCodes object

    Default chart-of-accounts mapping

    Hide defaultCodes attributes Show defaultCodes attributes object
    • id integer

      Default codes details ID

    • clientBalanceSheet integer

      Client balance sheet account ID

    • clientVAT integer

      Client VAT account ID

    • clientVATPaid integer

      Client VAT paid account ID

    • clientPrePayment integer

      Client pre-payment account ID

    • clientPL integer

      Client P&L account ID

    • supplierBalanceSheet integer

      Supplier balance sheet account ID

    • supplierVAT integer

      Supplier VAT account ID

    • supplierVATPaid integer

      Supplier VAT paid account ID

    • supplierPrePayment integer

      Supplier pre-payment account ID

    • retainedEarnings integer

      Retained earnings account ID

    • annualProfitLoss integer

      Annual profit/loss account ID

    • stock integer

      Stock account ID

    • stockMovements integer

      Stock movements account ID

    • bankExpenses integer

      Bank expenses account ID

    • transactionAdjustment integer

      Transaction adjustment account ID

    • accruedExpenses integer

      Accrued expenses account ID

    • accruedRevenue integer

      Accrued revenue account ID

    • compensation integer

      Compensation account ID

    • system integer

      System account ID

    • lossOnDebtors integer

      Loss on debtors account ID

    • workInProgress integer

      Work in progress account ID

    • workInvoicedUpfront integer

      Work invoiced upfront account ID

    • vatAccount integer

      VAT account ID

    • depreciationAccount integer

      Depreciation account ID

    • extraordinaryExpenseAccount integer

      Extraordinary expense account ID

    • extraordinaryIncomeAccount integer

      Extraordinary income account ID

    • unrealizedFxGainLossChart integer

      Unrealized FX gain/loss account ID

    • clientUnrealizedFXProfitLoss integer

      Client unrealized FX profit/loss account ID

    • supplierUnrealizedFXProfitLoss integer

      Supplier unrealized FX profit/loss account ID

    • supplierDiscountAccount integer

      Supplier discount account ID

    • fxgainLoss integer
  • disbursements array[object]

    Disbursement fee tier

    Hide disbursements attributes Show disbursements attributes object

    Disbursement fee tier

    • id integer

      Entity ID. If negative value, a new entity will be created

    • upToAmount string

      Upper amount bound for this tier, as string

    • disbursementFee string

      Disbursement fee for this tier, as string

  • tasks array[object]

    Timesheet task type defined at organization level

    Hide tasks attributes Show tasks attributes object

    Timesheet task type defined at organization level

    • id integer

      Entity ID. If negative value, a new entity will be created

    • name string Required

      Task name

    • rate number

      Hourly rate

    • archived boolean

      Whether the task is archived

  • organizationPayslips array[object]

    Organization payslip configuration for a calendar year

    Hide organizationPayslips attributes Show organizationPayslips attributes object

    Organization payslip configuration for a calendar year

    • id integer

      Entity ID. If negative value, a new entity will be created

    • calendarYear integer(int32) Required

      Calendar year

    • claPayslipId integer

      Salary configuration (payslip) ID

    • organizationPayslipLines array[object]

      Organization-specific override for a payslip line

      Hide organizationPayslipLines attributes Show organizationPayslipLines attributes object

      Organization-specific override for a payslip line

      • id integer

        Entity ID. If negative value, a new entity will be created

      • payslipLineEntityId integer Required

        Payslip line template ID

      • employeePercentage string

        Employee contribution percentage as string

      • employerPercentage string

        Employer contribution percentage as string

      • lowerLimit string

        Lower limit amount as string

      • upperLimit string

        Upper limit amount as string

      • limitCalculationType string

        How limits are calculated

        Values are TOTAL or OVER_THE_LOWER_LIMIT.

      • genderType string

        Gender this line applies to

        Values are MALE, FEMALE, or OTHER.

      • insurerId integer

        Insurer contact ID

      • code string

        Insurer code

      • insurerNumber string

        Insurer number

      • clientNumber string

        Client number with the insurer

      • contractNumber string

        Contract number

      • startDate string

        Start date (format dd/MM/yyyy)

    • salaryTableLines array[object]

      Salary table line used to compute payroll amounts per employee group

      Hide salaryTableLines attributes Show salaryTableLines attributes object

      Salary table line used to compute payroll amounts per employee group

      • id integer

        Entity ID. If negative value, a new entity will be created

      • startDate string

        Start date (format dd/MM/yyyy)

      • endDate string

        End date (format dd/MM/yyyy)

      • payslipLineId string

        Salary line reference ID (matches a payslip/salary code line)

      • number integer

        Line number

      • description string

        Description

      • employeeValue string

        Employee value as string

      • employerValue string

        Employer value as string

      • quantity string

        Quantity as string

      • employeePercentage string

        Employee percentage as string

      • employerPercentage string

        Employer percentage as string

      • organizationEmployeeGroupId integer

        Organization employee group ID

    • holidays array[object]

      Public holiday within a calendar year

      Hide holidays attributes Show holidays attributes object

      Public holiday within a calendar year

      • id integer

        Entity ID. If negative value, a new entity will be created

      • date string Required

        Date (format dd/MM/yyyy)

      • name string Required

        Holiday name

    • organizationOfficePayslips array[object]

      Office-specific payslip registration numbers

      Hide organizationOfficePayslips attributes Show organizationOfficePayslips attributes object

      Office-specific payslip registration numbers

      • id integer

        Entity ID. If negative value, a new entity will be created

      • organizationOfficeId integer Required

        Organization office ID

      • compensationFundNumber string

        Compensation fund number

      • compensationFundAffiliatedNumber string

        Compensation fund affiliated number

      • compensationFundId integer

        Compensation fund contact ID

      • childSupportAgencyId integer

        Child support agency contact ID

      • childSupportAgencyNumber string

        Child support agency number

      • childSupportAgencyAffiliatedNumber string

        Child support agency affiliated number

  • salaryCodes array[object]

    Organization salary code (yearly set of salary lines)

    Hide salaryCodes attributes Show salaryCodes attributes object

    Organization salary code (yearly set of salary lines)

    • id integer

      Salary code ID

    • calendarYear integer(int32) Required

      Calendar year

    • salaryCodeLines array[object]

      Single line within an organization salary code

      Hide salaryCodeLines attributes Show salaryCodeLines attributes object

      Single line within an organization salary code

      • id integer

        Salary code line ID

      • payslipLineEntityId integer

        Payslip line template ID

      • number integer

        Line number

      • localizations object

        Multilingual name (TranslationEntity with language fields)

        Hide localizations attributes Show localizations attributes object
        • id integer

          Entity ID. If negative value, a new entity will be created

        • en string
        • fr string
        • de string
        • it string
      • payslipLineType string

        Payslip line type

        Values are EMPLOYEE_LINE, COMPANY_LINE, BOTH, CALCULATION, or SYSTEM.

      • specialAttributionType string

        Special attribution type

        Values are BASE_SALARY, GROSS_SALARY, NET_SALARY, PAYABLE, CHARGES, EMPLOYEE_ALLOCATION, or SYSTEM_LINE_ADJUSTMENT.

      • isLinkedToAccount boolean

        Whether the line is linked to a chart of accounts

      • payslipValueSplitType string

        How the value is split between employer/operations

        Values are EMPLOYEE, EMPLOYER, or BOTH.

      • balanceSheetAccountId integer

        Balance sheet chart of accounts ID

      • plOperationsAccountId integer

        P&L operations chart of accounts ID

      • plAdminsAccountId integer

        P&L admins chart of accounts ID

  • mailServerConfig object

    Custom outgoing mail server configuration

    Hide mailServerConfig attributes Show mailServerConfig attributes object
    • id integer

      Entity ID. If negative value, a new entity will be created

    • host string

      SMTP host

    • port integer(int32)

      SMTP port

    • secureConnectionType string

      Secure connection type

      Values are TLS or NONE.

    • userName string

      SMTP username

    • password string

      SMTP password

    • useAuth boolean

      Whether authentication is required

    • fromEmail string

      From email address

    • authType string

      Authentication type

      Values are BASIC or OAUTH2.

    • oauthProvider string

      OAuth provider. Only relevant when authType = OAUTH

      Values are GOOGLE, MICROSOFT, or YAHOO.

    • accessToken string

      OAuth access token

    • refreshToken string

      OAuth refresh token

    • clientId string

      OAuth client ID

    • clientSecret string

      OAuth client secret

    • oauthScopes string

      OAuth scopes, space-separated

  • employeeGroups array[object]

    Employee group used for payslip line assignment

    Hide employeeGroups attributes Show employeeGroups attributes object

    Employee group used for payslip line assignment

    • id integer

      Entity ID. If negative value, a new entity will be created

    • name string Required

      Group name

    • payslipLineIds array[integer]

      Payslip line IDs assigned to this group

  • payslipLineCodes array[string]

    Payslip line codes applicable to this organization

  • ebics array[object]

    EBICS connection configuration for the organization

    Hide ebics attributes Show ebics attributes object

    EBICS connection configuration for the organization

    • id integer

      Entity ID. If negative value, a new entity will be created

    • ebicsServerId integer Required

      EBICS server ID

    • clientNumber string Required

      EBICS client number (fiduciary number)

    • userNumber string Required

      EBICS user number

    • orderTransmission boolean

      Whether order transmission is enabled

  • unusedVacationsSettings object

    Automatic accrual settings for unused vacation days

    Hide unusedVacationsSettings attributes Show unusedVacationsSettings attributes object
    • id integer

      Entity ID. If negative value, a new entity will be created

    • autoProvisionUnusedVacations boolean

      Whether unused vacations are automatically provisioned

    • adminBalanceSheetAccountId integer

      Admin staff balance sheet chart of accounts ID

    • adminPlAccountId integer

      Admin staff P&L chart of accounts ID

    • operationsBalanceSheetAccountId integer

      Operations staff balance sheet chart of accounts ID

    • operationsPlAccountId integer

      Operations staff P&L chart of accounts ID

  • organizationTemplates array[object]

    Named set of document templates for the organization

    Hide organizationTemplates attributes Show organizationTemplates attributes object

    Named set of document templates for the organization

    • id integer

      Entity ID. If negative value, a new entity will be created

    • name string Required

      Template set name. To make this the default template set, the name must be 'Default'.

    • documentTemplate object

      Document template set (logo, letterheads, PDF template references)

      Hide documentTemplate attributes Show documentTemplate attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • report integer

        Report background document file ID

      • letterheadPortrait integer

        Portrait letterhead document file ID

      • letterheadLandscape integer

        Landscape letterhead document file ID

      • salesInvoicesTemplateId integer

        PDF template ID used for sales invoices

      • lateNoticesTemplateId integer

        PDF template ID used for late notices

      • payslipsTemplateId integer

        PDF template ID used for payslips

      • salesOrderTemplateId integer

        PDF template ID used for sales orders

      • deliveryNoteTemplateId integer

        PDF template ID used for delivery notes

Responses

  • 200 application/json

    OK

    Hide response attribute Show response attribute object
    • items array[object]
      Hide items attributes Show items attributes object
      • errorCode object
        Hide errorCode attributes Show errorCode attributes object
        • errorCode string

          Values are NO_ERROR, NOT_IMPLEMENTED_YET, CONTACT_NOT_FOUND, FIELD_REQUIRED, VALIDATION_ERROR, DUPLICATION_ERROR, UNIQUE_CONSTRAINT_VIOLATION, WRONG_PASSWORD_FORMAT, WRONG_PASSWORD, ACTION_DENIED, NOT_FOUND, EXPECTED_ONE_FILE, UNIQUE_VIOLATION, CONTENT_EMPTY, INVALID_TYPE, CONVERSION_ERROR, FILE_PARSE_EXCEPTION, or IN_USE.

        • errorDetailValues array[object]
          Hide errorDetailValues attributes Show errorDetailValues attributes object
          • errorCode string
          • fieldName string
          • data string
          • isSevere boolean
      • freshData

        Refreshed domain data

      • freshRow

        Refreshed table row data

      • possibleWorkflows array[object]
        Hide possibleWorkflows attributes Show possibleWorkflows attributes object
        • id integer(int64)
        • name string
      • error boolean
      • severeError boolean
  • 400

    400 Bad Request

  • 401

    401 Unauthorized

  • 403

    403 Access Denied

  • 404

    404 Not Found

  • 500

    500 Internal Server Error

POST /api-v1/organization/batch
curl \
 --request POST 'https://wyzio.app/api-v1/organization/batch' \
 --header "Content-Type: application/json" \
 --data '[{"id":12345678,"name":"Acme Corp","currency":"CHF","mainLanguage":{"id":42,"code":"string","name":"string","isMain":true},"otherLanguages":[{"id":42,"code":"string","name":"string","isMain":true}],"parentStandaloneOrganizationId":12345678,"nogaCodeId":12345678,"startDate":"01/01/2026","endDate":"31/12/2026","externalId":"EXT-001","archived":false,"isFreeTier":false,"isConsolidated":false,"consolidatedOrganizationIds":[12345678],"stockStrategy":"FIFO","vatSupplierContactId":12345678,"useUnsentPayrollStatus":false,"uid":"CHE-123.456.789","automaticSynchronizationOfContacts":false,"auditorId":12345678,"isFiduciary":false,"banks":[{"id":12345678,"name":"Main Account","accountNumber":"CH56 0483 5012 3456 7800 9","qrIban":"CH44 3199 9123 0008 8901 2","isrCustomerNumber":"01-234567-8","bankCustomerNumber":123456,"swiftBic":"UBSWCHZH80A","bankName":"UBS AG","remark":"Primary account","position":1,"useForReconciliation":true,"chartOfAccounts":12345678,"accountHolderAddress":{"id":12345678,"name":"Main Office","line1":123,"line2":"Suite 4B","city":"Geneva","region":{"id":206},"countryCode2":"CH","countryId":12345678,"postCode":1200,"houseNumber":42,"toTheAttentionOf":"John Doe","position":1,"service":"HR"},"customHolder":false}],"officeAddresses":[{"id":12345678,"name":"Head Office","line1":123,"line2":"Suite 4B","city":"Geneva","region":{"id":206},"postCode":1200,"toTheAttentionOf":"John Doe","position":1,"countryId":12345678,"houseNumber":42,"service":"HR","dtbNumber":"DTB-001","cedNumber":"CED-001","fiduciaryId":12345678,"inventoryLocation":false}],"invoiceSettings":{"id":12345678,"defaultPaymentTerms":30,"emailForInvoiceScans":"scans@example.com","scansTreatedByManagingOrg":false,"validatePurchaseInvoicesByDefaultType":"MANUAL","usePurchaseAccrualAccounting":false,"skipDraftStatus":true,"plannedPaymentDateOffset":5,"purchasePaymentAccountId":12345678,"vatNumber":"CHE-123.456.789 MWST","requestedPaymentTerms":30,"numbering":"{YYYY}-{0000}","timesheets":false,"salesInvoiceConditionsLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"useSalesAccrualAccounting":false,"validateSalesInvoicesByDefaultType":"MANUAL","salesPaymentAccountId":12345678,"useUnsentSalesStatus":true,"lateInvoiceRequestedPaymentTerms":15,"lateInvoiceConditionsLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"orderIdNumbering":"{YYYY}-{0000}","expenseAccountId":12345678,"orderValidity":30,"validateOrdersByDefaultType":"MANUAL","timesheetsAccountId":12345678,"disbursementAccountId":12345678,"salesOrderTermsLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"useUnsentOrdersStatus":true,"forceTreatedAsPi":false,"invoiceEmailContentSettings":{"id":12345678,"salesInvoiceEmailSubjectLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"salesInvoiceEmailContentLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"customSalesInvoiceEmail":false,"lateNoticesEmailSubjectLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"lateNoticesEmailContentLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"customLateNoticeEmail":false,"orderEmailSubjectLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"orderEmailContentLocalizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"customSalesOrderEmail":false},"pdfInvoiceSplitterEnabled":false},"defaultCodes":{"id":12345678,"clientBalanceSheet":12345678,"clientVAT":12345678,"clientVATPaid":12345678,"clientPrePayment":12345678,"clientPL":12345678,"supplierBalanceSheet":12345678,"supplierVAT":12345678,"supplierVATPaid":12345678,"supplierPrePayment":12345678,"retainedEarnings":12345678,"annualProfitLoss":12345678,"stock":12345678,"stockMovements":12345678,"bankExpenses":12345678,"transactionAdjustment":12345678,"accruedExpenses":12345678,"accruedRevenue":12345678,"compensation":12345678,"system":12345678,"lossOnDebtors":12345678,"workInProgress":12345678,"workInvoicedUpfront":12345678,"vatAccount":12345678,"depreciationAccount":12345678,"extraordinaryExpenseAccount":12345678,"extraordinaryIncomeAccount":12345678,"unrealizedFxGainLossChart":12345678,"clientUnrealizedFXProfitLoss":12345678,"supplierUnrealizedFXProfitLoss":12345678,"supplierDiscountAccount":12345678,"fxgainLoss":42},"disbursements":[{"id":12345678,"upToAmount":1000.0,"disbursementFee":10.0}],"tasks":[{"id":12345678,"name":"Development","rate":100.0,"archived":false}],"organizationPayslips":[{"id":12345678,"calendarYear":2026,"claPayslipId":12345678,"organizationPayslipLines":[{"id":12345678,"payslipLineEntityId":12345678,"employeePercentage":5.25,"employerPercentage":8.0,"lowerLimit":0.0,"upperLimit":148200.0,"limitCalculationType":"YEARLY","genderType":"ALL","insurerId":12345678,"code":"IC-001","insurerNumber":"INS-2026","clientNumber":"CL-001","contractNumber":"CN-2026-001","startDate":"01/01/2026"}],"salaryTableLines":[{"id":12345678,"startDate":"01/01/2026","endDate":"31/12/2026","payslipLineId":12345678,"number":100,"description":"Base salary","employeeValue":5000.0,"employerValue":500.0,"quantity":1.0,"employeePercentage":5.25,"employerPercentage":8.0,"organizationEmployeeGroupId":12345678}],"holidays":[{"id":12345678,"date":"25/12/2026","name":"Christmas"}],"organizationOfficePayslips":[{"id":12345678,"organizationOfficeId":12345678,"compensationFundNumber":"CF-001","compensationFundAffiliatedNumber":"CFA-001","compensationFundId":12345678,"childSupportAgencyId":12345678,"childSupportAgencyNumber":"CSA-001","childSupportAgencyAffiliatedNumber":"CSAA-001"}]}],"salaryCodes":[{"id":12345678,"calendarYear":2026,"salaryCodeLines":[{"id":12345678,"payslipLineEntityId":12345678,"number":100,"localizations":{"id":12345678,"en":"English translation","fr":"Traduction française","de":"Deutsche Übersetzung","it":"Traduzione in italiano"},"payslipLineType":"COMPANY_LINE","specialAttributionType":"NONE","isLinkedToAccount":false,"payslipValueSplitType":"NONE","balanceSheetAccountId":12345678,"plOperationsAccountId":12345678,"plAdminsAccountId":12345678}]}],"mailServerConfig":{"id":12345678,"host":"smtp.example.com","port":587,"secureConnectionType":"STARTTLS","userName":"no-reply@example.com","password":"secret","useAuth":true,"fromEmail":"no-reply@example.com","authType":"BASIC","oauthProvider":"GOOGLE","accessToken":"string","refreshToken":"string","clientId":"string","clientSecret":"string","oauthScopes":"https://mail.google.com/"},"employeeGroups":[{"id":12345678,"name":"Management","payslipLineIds":[12345678]}],"payslipLineCodes":["AVS"],"ebics":[{"id":12345678,"ebicsServerId":12345678,"clientNumber":"CH1234","userNumber":"USER01","orderTransmission":false}],"unusedVacationsSettings":{"id":12345678,"autoProvisionUnusedVacations":false,"adminBalanceSheetAccountId":12345678,"adminPlAccountId":12345678,"operationsBalanceSheetAccountId":12345678,"operationsPlAccountId":12345678},"organizationTemplates":[{"id":12345678,"name":"Default","documentTemplate":{"id":12345678,"logo":12345678,"report":12345678,"letterheadPortrait":12345678,"letterheadLandscape":12345678,"salesInvoicesTemplateId":12345678,"lateNoticesTemplateId":12345678,"payslipsTemplateId":12345678,"salesOrderTemplateId":12345678,"deliveryNoteTemplateId":12345678}}]}]'
Request examples
# Headers

# Payload
[
  {
    "id": 12345678,
    "name": "Acme Corp",
    "currency": "CHF",
    "mainLanguage": {
      "id": 42,
      "code": "string",
      "name": "string",
      "isMain": true
    },
    "otherLanguages": [
      {
        "id": 42,
        "code": "string",
        "name": "string",
        "isMain": true
      }
    ],
    "parentStandaloneOrganizationId": 12345678,
    "nogaCodeId": 12345678,
    "startDate": "01/01/2026",
    "endDate": "31/12/2026",
    "externalId": "EXT-001",
    "archived": false,
    "isFreeTier": false,
    "isConsolidated": false,
    "consolidatedOrganizationIds": [
      12345678
    ],
    "stockStrategy": "FIFO",
    "vatSupplierContactId": 12345678,
    "useUnsentPayrollStatus": false,
    "uid": "CHE-123.456.789",
    "automaticSynchronizationOfContacts": false,
    "auditorId": 12345678,
    "isFiduciary": false,
    "banks": [
      {
        "id": 12345678,
        "name": "Main Account",
        "accountNumber": "CH56 0483 5012 3456 7800 9",
        "qrIban": "CH44 3199 9123 0008 8901 2",
        "isrCustomerNumber": "01-234567-8",
        "bankCustomerNumber": 123456,
        "swiftBic": "UBSWCHZH80A",
        "bankName": "UBS AG",
        "remark": "Primary account",
        "position": 1,
        "useForReconciliation": true,
        "chartOfAccounts": 12345678,
        "accountHolderAddress": {
          "id": 12345678,
          "name": "Main Office",
          "line1": 123,
          "line2": "Suite 4B",
          "city": "Geneva",
          "region": {
            "id": 206
          },
          "countryCode2": "CH",
          "countryId": 12345678,
          "postCode": 1200,
          "houseNumber": 42,
          "toTheAttentionOf": "John Doe",
          "position": 1,
          "service": "HR"
        },
        "customHolder": false
      }
    ],
    "officeAddresses": [
      {
        "id": 12345678,
        "name": "Head Office",
        "line1": 123,
        "line2": "Suite 4B",
        "city": "Geneva",
        "region": {
          "id": 206
        },
        "postCode": 1200,
        "toTheAttentionOf": "John Doe",
        "position": 1,
        "countryId": 12345678,
        "houseNumber": 42,
        "service": "HR",
        "dtbNumber": "DTB-001",
        "cedNumber": "CED-001",
        "fiduciaryId": 12345678,
        "inventoryLocation": false
      }
    ],
    "invoiceSettings": {
      "id": 12345678,
      "defaultPaymentTerms": 30,
      "emailForInvoiceScans": "scans@example.com",
      "scansTreatedByManagingOrg": false,
      "validatePurchaseInvoicesByDefaultType": "MANUAL",
      "usePurchaseAccrualAccounting": false,
      "skipDraftStatus": true,
      "plannedPaymentDateOffset": 5,
      "purchasePaymentAccountId": 12345678,
      "vatNumber": "CHE-123.456.789 MWST",
      "requestedPaymentTerms": 30,
      "numbering": "{YYYY}-{0000}",
      "timesheets": false,
      "salesInvoiceConditionsLocalizations": {
        "id": 12345678,
        "en": "English translation",
        "fr": "Traduction française",
        "de": "Deutsche Übersetzung",
        "it": "Traduzione in italiano"
      },
      "useSalesAccrualAccounting": false,
      "validateSalesInvoicesByDefaultType": "MANUAL",
      "salesPaymentAccountId": 12345678,
      "useUnsentSalesStatus": true,
      "lateInvoiceRequestedPaymentTerms": 15,
      "lateInvoiceConditionsLocalizations": {
        "id": 12345678,
        "en": "English translation",
        "fr": "Traduction française",
        "de": "Deutsche Übersetzung",
        "it": "Traduzione in italiano"
      },
      "orderIdNumbering": "{YYYY}-{0000}",
      "expenseAccountId": 12345678,
      "orderValidity": 30,
      "validateOrdersByDefaultType": "MANUAL",
      "timesheetsAccountId": 12345678,
      "disbursementAccountId": 12345678,
      "salesOrderTermsLocalizations": {
        "id": 12345678,
        "en": "English translation",
        "fr": "Traduction française",
        "de": "Deutsche Übersetzung",
        "it": "Traduzione in italiano"
      },
      "useUnsentOrdersStatus": true,
      "forceTreatedAsPi": false,
      "invoiceEmailContentSettings": {
        "id": 12345678,
        "salesInvoiceEmailSubjectLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "salesInvoiceEmailContentLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "customSalesInvoiceEmail": false,
        "lateNoticesEmailSubjectLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "lateNoticesEmailContentLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "customLateNoticeEmail": false,
        "orderEmailSubjectLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "orderEmailContentLocalizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "customSalesOrderEmail": false
      },
      "pdfInvoiceSplitterEnabled": false
    },
    "defaultCodes": {
      "id": 12345678,
      "clientBalanceSheet": 12345678,
      "clientVAT": 12345678,
      "clientVATPaid": 12345678,
      "clientPrePayment": 12345678,
      "clientPL": 12345678,
      "supplierBalanceSheet": 12345678,
      "supplierVAT": 12345678,
      "supplierVATPaid": 12345678,
      "supplierPrePayment": 12345678,
      "retainedEarnings": 12345678,
      "annualProfitLoss": 12345678,
      "stock": 12345678,
      "stockMovements": 12345678,
      "bankExpenses": 12345678,
      "transactionAdjustment": 12345678,
      "accruedExpenses": 12345678,
      "accruedRevenue": 12345678,
      "compensation": 12345678,
      "system": 12345678,
      "lossOnDebtors": 12345678,
      "workInProgress": 12345678,
      "workInvoicedUpfront": 12345678,
      "vatAccount": 12345678,
      "depreciationAccount": 12345678,
      "extraordinaryExpenseAccount": 12345678,
      "extraordinaryIncomeAccount": 12345678,
      "unrealizedFxGainLossChart": 12345678,
      "clientUnrealizedFXProfitLoss": 12345678,
      "supplierUnrealizedFXProfitLoss": 12345678,
      "supplierDiscountAccount": 12345678,
      "fxgainLoss": 42
    },
    "disbursements": [
      {
        "id": 12345678,
        "upToAmount": 1000.0,
        "disbursementFee": 10.0
      }
    ],
    "tasks": [
      {
        "id": 12345678,
        "name": "Development",
        "rate": 100.0,
        "archived": false
      }
    ],
    "organizationPayslips": [
      {
        "id": 12345678,
        "calendarYear": 2026,
        "claPayslipId": 12345678,
        "organizationPayslipLines": [
          {
            "id": 12345678,
            "payslipLineEntityId": 12345678,
            "employeePercentage": 5.25,
            "employerPercentage": 8.0,
            "lowerLimit": 0.0,
            "upperLimit": 148200.0,
            "limitCalculationType": "YEARLY",
            "genderType": "ALL",
            "insurerId": 12345678,
            "code": "IC-001",
            "insurerNumber": "INS-2026",
            "clientNumber": "CL-001",
            "contractNumber": "CN-2026-001",
            "startDate": "01/01/2026"
          }
        ],
        "salaryTableLines": [
          {
            "id": 12345678,
            "startDate": "01/01/2026",
            "endDate": "31/12/2026",
            "payslipLineId": 12345678,
            "number": 100,
            "description": "Base salary",
            "employeeValue": 5000.0,
            "employerValue": 500.0,
            "quantity": 1.0,
            "employeePercentage": 5.25,
            "employerPercentage": 8.0,
            "organizationEmployeeGroupId": 12345678
          }
        ],
        "holidays": [
          {
            "id": 12345678,
            "date": "25/12/2026",
            "name": "Christmas"
          }
        ],
        "organizationOfficePayslips": [
          {
            "id": 12345678,
            "organizationOfficeId": 12345678,
            "compensationFundNumber": "CF-001",
            "compensationFundAffiliatedNumber": "CFA-001",
            "compensationFundId": 12345678,
            "childSupportAgencyId": 12345678,
            "childSupportAgencyNumber": "CSA-001",
            "childSupportAgencyAffiliatedNumber": "CSAA-001"
          }
        ]
      }
    ],
    "salaryCodes": [
      {
        "id": 12345678,
        "calendarYear": 2026,
        "salaryCodeLines": [
          {
            "id": 12345678,
            "payslipLineEntityId": 12345678,
            "number": 100,
            "localizations": {
              "id": 12345678,
              "en": "English translation",
              "fr": "Traduction française",
              "de": "Deutsche Übersetzung",
              "it": "Traduzione in italiano"
            },
            "payslipLineType": "COMPANY_LINE",
            "specialAttributionType": "NONE",
            "isLinkedToAccount": false,
            "payslipValueSplitType": "NONE",
            "balanceSheetAccountId": 12345678,
            "plOperationsAccountId": 12345678,
            "plAdminsAccountId": 12345678
          }
        ]
      }
    ],
    "mailServerConfig": {
      "id": 12345678,
      "host": "smtp.example.com",
      "port": 587,
      "secureConnectionType": "STARTTLS",
      "userName": "no-reply@example.com",
      "password": "secret",
      "useAuth": true,
      "fromEmail": "no-reply@example.com",
      "authType": "BASIC",
      "oauthProvider": "GOOGLE",
      "accessToken": "string",
      "refreshToken": "string",
      "clientId": "string",
      "clientSecret": "string",
      "oauthScopes": "https://mail.google.com/"
    },
    "employeeGroups": [
      {
        "id": 12345678,
        "name": "Management",
        "payslipLineIds": [
          12345678
        ]
      }
    ],
    "payslipLineCodes": [
      "AVS"
    ],
    "ebics": [
      {
        "id": 12345678,
        "ebicsServerId": 12345678,
        "clientNumber": "CH1234",
        "userNumber": "USER01",
        "orderTransmission": false
      }
    ],
    "unusedVacationsSettings": {
      "id": 12345678,
      "autoProvisionUnusedVacations": false,
      "adminBalanceSheetAccountId": 12345678,
      "adminPlAccountId": 12345678,
      "operationsBalanceSheetAccountId": 12345678,
      "operationsPlAccountId": 12345678
    },
    "organizationTemplates": [
      {
        "id": 12345678,
        "name": "Default",
        "documentTemplate": {
          "id": 12345678,
          "logo": 12345678,
          "report": 12345678,
          "letterheadPortrait": 12345678,
          "letterheadLandscape": 12345678,
          "salesInvoicesTemplateId": 12345678,
          "lateNoticesTemplateId": 12345678,
          "payslipsTemplateId": 12345678,
          "salesOrderTemplateId": 12345678,
          "deliveryNoteTemplateId": 12345678
        }
      }
    ]
  }
]
Response examples (200)
{
  "items": [
    {
      "errorCode": {
        "errorCode": "NO_ERROR",
        "errorDetailValues": [
          {
            "errorCode": "string",
            "fieldName": "string",
            "data": "string",
            "isSevere": true
          }
        ]
      },
      "possibleWorkflows": [
        {
          "id": 42,
          "name": "string"
        }
      ],
      "error": true,
      "severeError": true
    }
  ]
}