Create or Update an Expenditure Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.plannrcrm.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "PlannrCRM MCP server": {
    "url": "https://apidocs.plannrcrm.com/mcp"
  }
}
Close
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
    • created_at string
    • updated_at string
    • name string
    • section string
    • amount object
      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
    • life_stage_uuid string
    • life_stage_section_uuid string
    • life_stage_field_uuid string
    • accounts string
  • 422 application/json

    Validation error

    Hide response attributes Show response attributes object
    • message string Required

      A human-readable description of the error.

    • errors object

      Validation messages keyed by the field that failed.

      Hide errors attribute Show errors attribute object
      • * array[string] Additional properties
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":"a491cddd-8a76-4c1c-ae40-9b6faf16131e"}'
Request examples 
{
  "amount": 50000,
  "life_stage_section_uuid": "a491cddd-8a76-4c1c-ae40-9b6faf16131e"
}
Response examples (200) 
[
  {
    "uuid": "1c4d0eae-9364-4059-a9f8-e48308915256",
    "created_at": "2026-08-07T15:29:24+01:00",
    "updated_at": "2026-08-07T15:29:24+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": "078799c7-1598-48d4-bd8a-2aa6fca6ac53",
    "life_stage_section_uuid": "dac82a11-e271-474d-9a82-c318ec6fa5be",
    "life_stage_field_uuid": "738c7f20-3a41-41c8-b0d2-bde14f4bf7c3",
    "accounts": "[]"
  }
]
Response examples (422) 
{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is invalid."
    ]
  }
}