Create or Update an Expenditure

POST /api/v1/client/{client_uuid}/expenditure/{lifeStage_uuid}/{lifeStageField_uuid}

Personal access token & OAuth2

This endpoint creates an individual expenditure for a client.

Headers

Authorization string
Content-Type string
Accept string

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 Required

amount integer Required

The amount of the expenditure in pennies.
life_stage_section_uuid string

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.
  
  Additional properties are allowed.
- 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

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 {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --data '{"amount":50000,"life_stage_section_uuid":"69d7daf4-dbe1-4b21-a8f6-687d8cbf101e"}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json

# Payload
{
  "amount": 50000,
  "life_stage_section_uuid": "69d7daf4-dbe1-4b21-a8f6-687d8cbf101e"
}

Response examples (200)

{
  "name": "Electricity",
  "uuid": "938831fd-b54b-4276-9e87-00e7f481e265",
  "amount": {
    "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"
    }
  },
  "section": "Housekeeping Expenses",
  "position": "1",
  "created_at": "2025-02-20T10:13:01+00:00",
  "updated_at": "2025-02-20T10:13:01+00:00",
  "life_stage_uuid": "571afe0d-2731-417a-82ce-11943ad10a3e",
  "life_stage_field_uuid": "0cdb592f-ded9-462d-b2f1-f9b6f6c43e74",
  "life_stage_section_uuid": "2f7d4f84-b35c-40a6-8c0c-a36e5917fddb"
}