# Create client

Creates a client record (company or individual) with identifiers (name, displayName, optional id), regulatory and operational details (crn, country), optional bank accounts for fee handling, and service types. The response returns the full persisted client including sortedId and timestamps.

Endpoint: POST /v2/partner/client
Version: 2.0.0
Security: oAuth

## Request fields (application/json):

  - `name` (string, required)
    Name of client
    Example: "Advise AB"

  - `displayName` (string, required)
    Name of client as displayed in journeys
    Example: "Advise"

  - `bankAccounts` (array)
    Bank account defintions based on fee type. No duplicate feeTypes allowed

  - `bankAccounts.feeType` (string, required)
    Fee type

  - `bankAccounts.iban` (string, required)
    IBAN (ISO 13616, International Bank Account Number)
    Example: "SE7280000810340009783242"

  - `serviceTypes` (array, required)

  - `serviceTypes.accountServiceType` (any, required)
    Account service type

  - `crn` (string, required)
    Company registration number
    Example: "1034567891"

  - `country` (string, required)
    Two-letter country code
    Example: "SE"

## Response 204 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)
    Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"

  - `name` (string, required)
    Name of client
    Example: "Advise AB"

  - `displayName` (string, required)
    Name of client as displayed in journeys
    Example: "Advise"

  - `bankAccounts` (array)
    Bank account defintions based on fee type. No duplicate feeTypes allowed

  - `bankAccounts.feeType` (string, required)
    Fee type

  - `bankAccounts.iban` (string, required)
    IBAN (ISO 13616, International Bank Account Number)
    Example: "SE7280000810340009783242"

  - `serviceTypes` (array, required)

  - `serviceTypes.accountServiceType` (any, required)
    Account service type

  - `serviceTypes.code` (string)
    client activation code. 6 digits
    Example: "123456"

  - `createdDate` (string)
    Date when acocunt was created
    Example: "2018-12-13T23:59:00.001Z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `crn` (string, required)
    Company registration number
    Example: "1034567891"

  - `country` (string, required)
    Two-letter country code
    Example: "SE"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error