POST /api/v1/client/{client_uuid}/expenditure/{lifeStage_uuid}/{lifeStageField_uuid}
Personal access token & O auth2

This endpoint creates an individual expenditure for a client.

Path parameters

  • client_uuid string Required

    The uuid of the client.

  • lifeStage_uuid string Required

    The uuid of the parent Life Stage.

  • lifeStageField_uuid string Required

    The uuid of the parent Life Stage Field.

application/json

Body

  • amount integer Required

    The amount of the expenditure in pennies.

  • life_stage_section_uuid string(uuid)

    The life stage section UUID.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • uuid string

      UUID of the Expenditure

    • created_at string

      The timestamp of when the resource was created.

    • updated_at string

      The timestamp of when the resource was updated.

    • name string

      The name of the Expenditure.

    • section string

      The Life Stage Section of the Expenditure.

    • amount object

      The amount of the Expenditure.

      Hide amount attributes Show amount attributes object
      • amount object
        Hide amount attributes Show amount attributes object
        • example string
        • description string
      • formatted object
        Hide formatted attributes Show formatted attributes object
        • example string
        • description string
      • currency object
        Hide currency attributes Show currency attributes object
        • example string
        • description string
    • position string

      The position/order of the Expenditure in any listing.

    • life_stage_uuid string

      UUID of the Life Stage

    • life_stage_section_uuid string

      UUID of the parent Life Stage Section

    • life_stage_field_uuid string

      UUID of the parent Life Stage Field

    • accounts string

      The accounts associated with this expenditure. Only present when loaded.
POST /api/v1/client/{client_uuid}/expenditure/{lifeStage_uuid}/{lifeStageField_uuid} 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/client/f6aa1670-dcf0-484e-a0c5-08590fe89a84/expenditure/dcf0-484e-a0c5-08590fe89a84-f6aa1670/dcf0-484e-a0c5-08590fe89a84-f6aa1670' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"amount":50000,"life_stage_section_uuid":"7e9d720e-4f3d-45a0-89bf-9a08cbe190b2"}'
Request examples 
{
  "amount": 50000,
  "life_stage_section_uuid": "7e9d720e-4f3d-45a0-89bf-9a08cbe190b2"
}
Response examples (200) 
{
  "uuid": "7a3ced01-0758-4cef-b843-cc46805986b3",
  "created_at": "2026-04-29T12:52:59+01:00",
  "updated_at": "2026-04-29T12:52:59+01:00",
  "name": "Electricity",
  "section": "Housekeeping Expenses",
  "amount": {
    "amount": {
      "example": "4000",
      "description": "Money amount at their lowest denominator (for example: pennies)"
    },
    "formatted": {
      "example": "£40.00",
      "description": "Money amount formatted with currency"
    },
    "currency": {
      "example": "GBP",
      "description": "Currency of the money"
    }
  },
  "position": "1",
  "life_stage_uuid": "ffbce4ee-bf6a-4d43-a354-8b06806c319e",
  "life_stage_section_uuid": "be6fed95-2baf-4fa3-8b51-9f790b45c5d4",
  "life_stage_field_uuid": "86bea494-5351-4106-b3ea-5c5bb6d33279",
  "accounts": "[]"
}