Update a charge split schema

PUT /api/v1/charge-split-schema/{chargeSplitSchema_uuid}

Personal access token & O auth2

Headers

X-PLANNR-ACCOUNT-UUID string

Path parameters

chargeSplitSchema_uuid string Required

application/json

Body

name string

Introducer split name
min_percentage number

Minimum percentage of overall charge introducer can be entitled to. Required with max_percentage and default_percentage
max_percentage number

Maximum percentage of overall charge introducer can be entitled to. Required with max_percentage and default_percentage
default_percentage number

Default percentage of overall charge introducer can be entitled to. Must be between minimum and maximum. Required with min_percentage and max_percentage
percentage_paid_by_firm number

Percentage of the introducer's cut of the expected amount to be paid by the firm. Required with percentage_paid_by_adviser
percentage_paid_by_adviser number

Percentage of the introducer's cut of the expected amount to be paid by the selling adviser. Required with percentage_paid_by_firm
can_change_transfer_fci boolean

Whether the value for FCI contributions can be changed. Will only apply to advisers
default_transfer_fci boolean

Default value to whether the introducer will be recognised for FCI contributions. Will only apply to advisers
can_change_initial boolean

Whether the value for initial charges can be changed
default_initial boolean

Default value to whether this charge split schema will be applied to initial charges
can_change_ongoing boolean

Whether the value for ongoing charges can be changed
default_ongoing boolean

Default value to whether this charge split schema will be applied to ongoing charges
valid_for_advisers boolean

Whether this charge split schema can be applied for adviser accounts
valid_for_clients boolean

Whether this charge split schema can be applied for client accounts
valid_for_introducers boolean

Whether this charge split schema can be applied for introducer accounts
visible_to_advisers boolean

Whether this charge split schema is visible to advisers to use

Responses

200 application/json
Hide response attributes Show response attributes object
- uuid string
  
  The UUID of the resource.
- created_at string
  
  The timestamp of when the resource was created.
- updated_at string
  
  The timestamp of when the resource was updated.
- name string
  
  Introducer split name
- min_percentage integer
  
  Minimum percentage of overall charge introducer can be entitled to
- max_percentage integer
  
  Maximum percentage of overall charge introducer can be entitled to
- default_percentage integer
  
  Default percentage of overall charge introducer can be entitled to. Must be between minimum and maximum
- percentage_paid_by_firm integer
  
  Percentage of the introducer's cut of the expected amount to be paid by the firm
- percentage_paid_by_adviser integer
  
  Percentage of the introducer's cut of the expected amount to be paid by the selling adviser
- can_change_transfer_fci boolean
  
  Whether the value for FCI contributions can be changed. Will only apply to advisers
- default_transfer_fci boolean
  
  Default value to whether the introducer will be recognised for FCI contributions. Will only apply to advisers
- can_change_initial boolean
  
  Whether the value for initial charges can be changed
- default_initial boolean
  
  Default value to whether this charge split schema will be applied to initial charges
- can_change_ongoing boolean
  
  Whether the value for ongoing charges can be changed
- default_ongoing boolean
  
  Default value to whether this charge split schema will be applied to ongoing charges
- valid_for_advisers boolean
  
  Whether this charge split schema can be applied for adviser accounts
- valid_for_clients boolean
  
  Whether this charge split schema can be applied for client accounts
- valid_for_introducers boolean
  
  Whether this charge split schema can be applied for introducer accounts
- visible_to_advisers boolean
  
  Whether this charge split schema is visible to advisers to use

PUT /api/v1/charge-split-schema/{chargeSplitSchema_uuid}

curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/charge-split-schema/6ff8f7f6-1eb3-3525-be4a-3932c805afed' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Basic Introducer Rate","min_percentage":10.0,"max_percentage":20.0,"default_percentage":15.0,"percentage_paid_by_firm":25.0,"percentage_paid_by_adviser":75.0,"can_change_transfer_fci":true,"default_transfer_fci":true,"can_change_initial":true,"default_initial":true,"can_change_ongoing":true,"default_ongoing":true,"valid_for_advisers":true,"valid_for_clients":true,"valid_for_introducers":true,"visible_to_advisers":true}'

Request examples

# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Basic Introducer Rate",
  "min_percentage": 10.0,
  "max_percentage": 20.0,
  "default_percentage": 15.0,
  "percentage_paid_by_firm": 25.0,
  "percentage_paid_by_adviser": 75.0,
  "can_change_transfer_fci": true,
  "default_transfer_fci": true,
  "can_change_initial": true,
  "default_initial": true,
  "can_change_ongoing": true,
  "default_ongoing": true,
  "valid_for_advisers": true,
  "valid_for_clients": true,
  "valid_for_introducers": true,
  "visible_to_advisers": true
}

Response examples (200)

{
  "name": "Basic Introducer Rate",
  "uuid": "46926837-43b2-425d-b3a0-402ffe029d26",
  "created_at": "2025-06-26T11:37:10+01:00",
  "updated_at": "2025-06-26T11:37:10+01:00",
  "max_percentage": 20,
  "min_percentage": 10,
  "default_initial": true,
  "default_ongoing": true,
  "valid_for_clients": true,
  "can_change_initial": true,
  "can_change_ongoing": true,
  "default_percentage": 15,
  "valid_for_advisers": true,
  "visible_to_advisers": true,
  "default_transfer_fci": true,
  "valid_for_introducers": true,
  "can_change_transfer_fci": true,
  "percentage_paid_by_firm": 25,
  "percentage_paid_by_adviser": 75
}