Skip to main content
POST
/
wealth
/
accounts
/
{account_id}
/
life-events
curl --request POST \
  --url https://api.bluumfinance.com/v1/wealth/accounts/{account_id}/life-events \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "College for Sarah",
  "event_type": "college",
  "expected_date": "2030-09-01",
  "estimated_cost": "100000.00",
  "notes": "4-year university tuition and expenses"
}
'
{
  "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "College for Sarah",
  "event_type": "college",
  "expected_date": "2023-12-25",
  "estimated_cost": "<string>",
  "currency": "USD",
  "recurring": false,
  "linked_goal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "notes": "<string>",
  "status": "active",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Headers

​
Idempotency-Key
string

Unique key for idempotent operation

Maximum string length: 128

Path Parameters

​
account_id
string<uuid>
required

The investor account ID

Body

application/json

Request body for creating a life event

​
name
string
required
Required string length: 1 - 100
​
event_type
enum<string>
required
Available options:
college,
wedding,
home_purchase,
retirement,
major_purchase,
career_change,
custom
​
expected_date
string<date>
​
estimated_cost
string
Pattern: ^\d+(\.\d{2})?$
​
currency
string
default:USD
Pattern: ^[A-Z]{3}$
​
recurring
boolean
default:false
​
linked_goal_id
string<uuid>
​
notes
string
Maximum string length: 500

Response

Life event created successfully

A planned major life event

​
event_id
string<uuid>
​
account_id
string<uuid>

The investor account this event belongs to

​
name
string
Example:

"College for Sarah"

​
event_type
enum<string>
Available options:
college,
wedding,
home_purchase,
retirement,
major_purchase,
career_change,
custom
​
expected_date
string<date>
​
estimated_cost
string

Estimated cost/impact

​
currency
string
default:USD
Pattern: ^[A-Z]{3}$
​
recurring
boolean
default:false
​
linked_goal_id
string<uuid>

Optionally link to a goal

​
notes
string
Maximum string length: 500
​
status
enum<string>
default:active
Available options:
active,
completed,
archived
​
created_at
string<date-time>
​
updated_at
string<date-time>