Folders

In our Accounting API:
  • A folder represents one legal entity.
  • Each folder contains isolated accounting data.
The multi-folder feature allows a single connection to access and manage multiple folders/entities (this is typically useful for accountants). How It Works
  1. Regular Mode (Single-Folder)
    • Enabled by default — no setup needed.
    • A connection is linked to one folder (selected during connector activation).
    • The folder_id query parameter is ignored.
    • All API calls operate on this single folder.
  2. Multi-Folder Mode
    • Allows a consumer to manage multiple legal entities.
    • Each API request MUST include afolder_idquery parameter to specify the target folder (except for the GET folders endpoint).
    • This ensures full data segregation and prevents cross-entity issues.
Activation & Configuration To activate the multi-folder feature, go to the configuration page of your connector (if connector supports it), and enable the feature by unchecking the box that is ticked by default (i.e. “Let the user specify the folder” -> No”: image.png Important Notes
  • Billing won’t be impacted by your design choice as invoicing is done at folder level
  • Not all connectors support multi-folder. Check the connector’s documentation page to confirm compatibility. .
  • Your implementation must support both modes (single and multi-folder) for full compatibility.
  • Additional dev work is required to integrate multi-folder support. (See implementation section below.)
Implementation Guide
  • Retrieve Available Folders Use GET /folders to list all folders linked to the connection. Each one represents a legal entity.
  • Map Folder IDs Internally Create a mapping between each folder_id and its corresponding legal entity in your system. When a user selects “Company X,” your API calls should use its folder_id.
  • One Folder = One Legal Entity Do not merge data between folders or assume shared context. Each folder is fully isolated (chart of accounts, transactions, etc.).