Create a charge split

POST /api/v1/charge-split

Personal access token & O auth2

Headers

application/json

Body Required

splitable_type string Required

The model type the charge split is being added to. Valid options are: client, plan, charge
splitable_uuid string Required

The model UUID belonging to the splitable_type the charge split is being added to
account_uuid string Required

The account UUID of who will be receiving this charge split
charge_split_schema_uuid string Required

The charge split schema that defines the parameters of this charge split
percentage number Required

Percentage of charge that the introducer will receive. Must be within the provided charge split schema min and max percentage bounds
transfer_fci boolean Required

Whether the account will receive FCI recognition for this charge split. Provided charge split schema must allow option to be changed
initial boolean Required

Whether this charge split will be applied to initial charges. Provided charge split schema must allow option to be changed
ongoing boolean Required

Whether this charge split will be applied to ongoing charges. Provided charge split schema must allow option to be changed
apply_to_plans boolean

When adding a charge split against a client, you can choose whether to automatically apply to the client's plans too. Must be null or false for a plan splitable_type

Responses

201 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.
- splitable_type string
  
  The model type this charge split belongs to.
- splitable object
  
  Model this charge split belongs to e.g. plan
- account object
  
  Account who will be receiving this charge split
- charge_split_schema object
  
  The charge split schema model that defined the parameters of this charge split
- percentage number
  
  How much of the expectation the given account is expected to receive
- percentage_paid_by_firm integer
  
  How much of the charge split amount will be paid by the firm
- percentage_paid_by_adviser integer
  
  How much of the charge split amount will be paid by the adviser
- transfer_fci string
  
  Whether the account will receive FCI recognition for this expectation amount
- initial string
  
  Whether the charge split will apply to initial charges
- ongoing string
  
  Whether the charge split will apply to ongoing charges
- apply_to_plans boolean
  
  When adding this charge split to a client, setting this to true will automatically apply the charge split to all of the client's plans

POST /api/v1/charge-split

curl \
 --request POST 'https://api.plannrcrm.com/api/v1/charge-split' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"splitable_type":"plan","splitable_uuid":"f38da6f8-67cb-475e-9a6a-a6cf78d5c1bb","account_uuid":"df592321-2e4a-4428-8c38-40ba7a67e97a","charge_split_schema_uuid":"88113a86-8ddc-4b3a-9032-2745d620eba1","percentage":12.5,"transfer_fci":true,"initial":true,"ongoing":true,"apply_to_plans":true}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "splitable_type": "plan",
  "splitable_uuid": "f38da6f8-67cb-475e-9a6a-a6cf78d5c1bb",
  "account_uuid": "df592321-2e4a-4428-8c38-40ba7a67e97a",
  "charge_split_schema_uuid": "88113a86-8ddc-4b3a-9032-2745d620eba1",
  "percentage": 12.5,
  "transfer_fci": true,
  "initial": true,
  "ongoing": true,
  "apply_to_plans": true
}

Response examples (201)

{
  "uuid": "967fee5b-5e3d-4842-861d-03e08cc42489",
  "account": {
    "firm": "App\\Http\\Resources\\FirmResource",
    "name": "Gareth Thompson",
    "role": "client",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "client",
    "uuid": "384e7c82-9d41-4166-b408-191ac23b3dee",
    "email": "gareth@codepotato.co.uk",
    "groups": "App\\Http\\Resources\\GroupResource",
    "owners": "App\\Http\\Resources\\AccountResource",
    "last_name": "Thompson",
    "created_at": "2025-04-02T13:27:58+01:00",
    "first_name": "Gareth",
    "updated_at": "2025-04-02T13:27:58+01:00",
    "with_login": true,
    "inactive_at": "2025-04-02",
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "introduced_by": "App\\Http\\Resources\\AccountResource",
    "primary_email": "App\\Http\\Resources\\ContactDetailResource",
    "can_be_deleted": "false",
    "assigned_adviser": "App\\Http\\Resources\\AccountResource",
    "next_review_date": "2025-04-02T13:27:58+01:00",
    "has_joint_account": true,
    "current_time_entry": "App\\Http\\Resources\\TimeEntryResource",
    "first_contact_date": "2025-04-02T13:27:58+01:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
    "assigned_paraplanner": "App\\Http\\Resources\\AccountResource",
    "joint_account_circle": "App\\Http\\Resources\\CircleResource",
    "ownership_percentage": 100,
    "previous_review_date": "2025-04-02T13:27:58+01:00",
    "primary_phone_number": "App\\Http\\Resources\\ContactDetailResource",
    "assigned_administrator": "App\\Http\\Resources\\AccountResource",
    "anniversary_review_date": "2025-04-02T13:27:58+01:00"
  },
  "initial": "example",
  "ongoing": "example",
  "splitable": {
    "name": "Johns ISA",
    "tags": "App\\Http\\Resources\\TagResource",
    "type": "cash_account",
    "uuid": "c2c25388-c861-49a2-b699-9ff0f5aaa2be",
    "wrap": "App\\Http\\Resources\\Plans\\PlanResource",
    "cases": "App\\Http\\Resources\\CasesResource",
    "value": {
      "amount": {
        "example": "4000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£40.00",
        "description": "Money amount formatted with currency"
      }
    },
    "claims": "App\\Http\\Resources\\Plans\\ClaimResource",
    "client": "App\\Http\\Resources\\AccountResource",
    "covers": "App\\Http\\Resources\\Plans\\CoverResource",
    "seller": "App\\Http\\Resources\\AccountResource",
    "status": "inactive",
    "accounts": "App\\Http\\Resources\\AccountResource",
    "on_panel": true,
    "provider": "App\\Http\\Resources\\Plans\\ProviderResource",
    "sub_type": "lifetime isa",
    "opened_at": "2025-04-02T13:27:58+01:00",
    "valued_at": "2025-04-02T13:27:58+01:00",
    "created_at": "2025-04-02T13:27:58+01:00",
    "statistics": {
      "recent_growth": 100
    },
    "updated_at": "2025-04-02T13:27:58+01:00",
    "advice_area": "non_investment_insurance",
    "inactive_at": "2025-04-02T13:27:58+01:00",
    "review_date": "2024-04-02",
    "linked_plans": "App\\Http\\Resources\\Plans\\PlanResource",
    "main_account": "App\\Http\\Resources\\Plans\\SubAccountResource",
    "sub_accounts": "App\\Http\\Resources\\Plans\\SubAccountResource",
    "under_advice": true,
    "abstract_type": "asset",
    "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource",
    "is_wrap_child": false,
    "linked_owners": "App\\Http\\Resources\\AccountResource",
    "policy_number": "AVIVA-123",
    "show_on_joint": true,
    "wrap_children": "App\\Http\\Resources\\Plans\\PlanResource",
    "can_be_deleted": "false",
    "total_benefits": {
      "critical_illness": {
        "amount": {
          "example": "15000000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        },
        "formatted": {
          "example": "£150,000.00",
          "description": "Money amount formatted with currency"
        }
      },
      "family_income_benefit": {
        "amount": {
          "example": "10000000",
          "description": "Money amount at their lowest denominator (for example: pennies)"
        },
        "currency": {
          "example": "GBP",
          "description": "Currency of the money"
        },
        "formatted": {
          "example": "£100,000.00",
          "description": "Money amount formatted with currency"
        }
      }
    },
    "inactive_reason": "claimed",
    "is_group_scheme": false,
    "is_wrap_product": false,
    "latest_valuations": "App\\Http\\Resources\\Plans\\ValuationResource",
    "proposal_reference": "AB123456",
    "agency_in_your_name": true,
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource",
    "is_sub_group_scheme": false,
    "total_benefit_amount": {
      "amount": {
        "example": "25000000",
        "description": "Money amount at their lowest denominator (for example: pennies)"
      },
      "currency": {
        "example": "GBP",
        "description": "Currency of the money"
      },
      "formatted": {
        "example": "£250,000.00",
        "description": "Money amount formatted with currency"
      }
    },
    "is_group_scheme_member": false,
    "originally_sold_by_firm": true,
    "agency_in_your_name_from": "2024-04-02",
    "contract_enquiry_account": "App\\Http\\Resources\\AccountResource",
    "visible_on_client_portal": true,
    "include_in_client_valuation": true
  },
  "created_at": "2025-04-02T13:27:58+01:00",
  "percentage": 12.5,
  "updated_at": "2025-04-02T13:27:58+01:00",
  "transfer_fci": "example",
  "apply_to_plans": true,
  "splitable_type": "plan",
  "charge_split_schema": {
    "name": "Basic Introducer Rate",
    "uuid": "beab25a5-9ab0-48c1-bcf4-c17f9f7052da",
    "created_at": "2025-04-02T13:27:58+01:00",
    "updated_at": "2025-04-02T13:27:58+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
  },
  "percentage_paid_by_firm": 0,
  "percentage_paid_by_adviser": 100
}