{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml","oas-openapi/api.yaml":"oas-openapi/api.yaml"},"props":{"metadata":{"markdoc":{"tagList":["openapi-code-sample","json-schema"]},"type":"markdown"},"seo":{"title":"2. Create a Client","description":"Fondo is the ground breaking open finance platform that lets you focus on what matters","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"2-create-a-client","__idx":0},"children":["2. Create a Client"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["client"]}," represents the legal entity that holds power of attorney over end-investor accounts. How many clients you need depends on your setup:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Direct model"]}," — your company itself holds power of attorney. You have a single client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Intermediary model"]}," — other organisations hold power of attorney through your platform. You create one client per organisation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"permissions","__idx":1},"children":["Permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Client permissions are configured in two layers:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partner level"]}," — default settings that all your clients inherit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client level"]}," — overrides for individual clients when needed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customized power of attorney forms are possible on client level. This is considered an edge case and must be manually setup by Fondo."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-openapi/api.yaml","operationId":"createClient","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response returns the persisted client including its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," (used in all subsequent calls) and an activation ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," per service type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-schema","__idx":2},"children":["Request schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../../../openapi/models/client/post_client.yaml"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/post_client"},"fee_types":{"$id":"/models/transaction/fee_types.yaml","title":"feeType","type":"string","description":"- `client_fee_oneoff` — One-off fee\n- `client_fee_ongoing` — Ongoing fee\n- `client_fee_transaction` — Transactional fee\n- `client_fee_performance` — Performance fee\n- `client_fee_other` — Other fee\n","enum":["client_fee_oneoff","client_fee_ongoing","client_fee_transaction","client_fee_performance","client_fee_other"]},"bank_account":{"$id":"/models/client/bank_account.yaml","title":"bankAccount","type":"object","description":"Bank account definition based on fee type","required":["feeType","iban"],"additionalProperties":false,"properties":{"feeType":{"$ref":"#/components/schemas/fee_types"},"iban":{"type":"string","description":"IBAN (ISO 13616, International Bank Account Number)","example":"SE7280000810340009783242"}}},"serviceType":{"title":"Account service type","type":"string","description":"- `portfolioManagement` — Portfolio management\n- `investmentAdvise` — Investment advice\n- `executionOnly` — Execution only\n","enum":["portfolioManagement","investmentAdvise","executionOnly"]},"service_type":{"$id":"/models/client/service_type.yaml","title":"serviceType","type":"object","description":"Supported Service Type","required":["accountServiceType"],"additionalProperties":false,"properties":{"accountServiceType":{"$ref":"#/components/schemas/serviceType"},"code":{"readOnly":true,"type":"string","description":"client activation code. 6 digits","example":"123456","pattern":"^[0-9]{6}$"}}},"crn":{"$id":"/models/crn.yaml","type":"string","minLength":10,"maxLength":10,"pattern":"\\d{10}","example":"5011121421"},"post_client":{"$id":"/models/client/post_client.yaml","title":"client","type":"object","required":["name","displayName","crn","serviceTypes","country"],"additionalProperties":false,"properties":{"displayName":{"type":"string","description":"Name of client as displayed in journeys","example":"Advise"},"name":{"type":"string","description":"Name of client","example":"Advise AB"},"bankAccounts":{"type":"array","description":"Bank account defintions based on fee type. No duplicate feeTypes allowed","uniqueItems":true,"items":{"$ref":"#/components/schemas/bank_account"}},"serviceTypes":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/service_type"}},"crn":{"$ref":"#/components/schemas/crn","description":"Company registration number. 10-digits"},"country":{"type":"string","description":"Two-letter country code","pattern":"^[A-Z][A-Z]$","example":"SE"}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/api-guide/getting-started/onboard-customer"},"children":["Onboard a customer"]}]}]},"headings":[{"value":"2. Create a Client","id":"2-create-a-client","depth":1},{"value":"Permissions","id":"permissions","depth":3},{"value":"Request schema","id":"request-schema","depth":3}],"frontmatter":{"seo":{"title":"2. Create a Client"}},"lastModified":"2026-04-14T12:45:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/api-guide/getting-started/create-client","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}