Skip to content
Last updated

A client represents the legal entity that holds power of attorney over end-investor accounts. How many clients you need depends on your setup:

  • Direct model — your company itself holds power of attorney. You have a single client.
  • Intermediary model — other organisations hold power of attorney through your platform. You create one client per organisation.

Permissions

Client permissions are configured in two layers:

  1. Partner level — default settings that all your clients inherit.
  2. Client level — overrides for individual clients when needed.

Customized power of attorney forms are possible on client level. This is considered an edge case and must be manually setup by Fondo.

curl -i -X POST \
  https://api.sandbox.fondo.se/v2/partner/client \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
    "displayName": "Advise",
    "name": "Advise AB",
    "bankAccounts": [
      {
        "feeType": "client_fee_oneoff",
        "iban": "SE7280000810340009783242"
      }
    ],
    "serviceTypes": [
      {
        "accountServiceType": "portfolioManagement"
      }
    ],
    "crn": "5011121421",
    "country": "SE"
  }'

The response returns the persisted client including its id (used in all subsequent calls) and an activation code per service type.

Request schema

displayNamestringrequired

Name of client as displayed in journeys

Example: "Advise"
namestringrequired

Name of client

Example: "Advise AB"
bankAccountsArray of objects(bankAccount)unique

Bank account defintions based on fee type. No duplicate feeTypes allowed

serviceTypesArray of objects(serviceType)non-emptyrequired
serviceTypes[].​accountServiceTypestring(Account service type)required
  • portfolioManagement — Portfolio management
  • investmentAdvise — Investment advice
  • executionOnly — Execution only
Enum"portfolioManagement""investmentAdvise""executionOnly"
serviceTypes[].​codestring^[0-9]{6}$read-only

client activation code. 6 digits

Example: "123456"
crnstring(crn)= 10 characters\d{10}required
Example: "5011121421"
countrystring^[A-Z][A-Z]$required

Two-letter country code

Example: "SE"

Next: Onboard a customer