Clients - Platform Import
Import clients from third-party platforms (e.g., Xero, QuickBooks) or via direct import with comprehensive data. Includes direct import (create client with all related data in one request), listing available clients from connected platforms, and importing selected or all clients with optional Companies House enrichment. Uses a sync-when-fast pattern for platform imports (waits up to 10 seconds, returns 201 if completed, 202 if still processing).
-
GET List Available ClientsReturns a paginated list of clients available for import from the specified third-party connection. This endpoint does not import any data - it only l.../tenants/{tenant}/clients/import/available
-
POST Import clients from a third-party connectionImports clients from the third-party platform. This endpoint uses a hybrid approach: it queues the import job and waits up to 10 seconds for completio.../tenants/{tenant}/clients/import/from-connection
-
POST Map External ClientManually maps an external platform client to an existing Sodium client. Creates an ImportedClients record with IsManuallyMapped = true, allowing the e.../tenants/{tenant}/clients/import/map-client