Skip to main content
POST
/
v1
/
households
/
{household_id}
/
trusts
Create a trust
curl --request POST \
  --url https://api.slant.app/v1/households/{household_id}/trusts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Smith Family Trust",
  "tax_id": "12-3456789",
  "additional_info": "Revocable living trust"
}
'
{
  "id": "abc123xyz",
  "book_id": "book123xyz",
  "household_id": "household123xyz",
  "name": "Smith Family Trust",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "tax_id": "12-3456789",
  "additional_info": "<string>"
}

Authorizations

Authorization
string
header
required

OAuth 2.0 Bearer Token from Clerk authentication

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Path Parameters

household_id
string
required

The household ID

Body

application/json
name
string
required

Trust name

Example:

"Smith Family Trust"

tax_id
string

Tax ID

Example:

"12-3456789"

additional_info
string

Additional information

Example:

"Revocable living trust"

Response

trust created

id
string
required

The trust ID

Example:

"abc123xyz"

book_id
string
required

The book ID

Example:

"book123xyz"

household_id
string
required

The household ID

Example:

"household123xyz"

name
string
required

Trust name

Example:

"Smith Family Trust"

created_at
string<date-time>
required

When the trust was created

updated_at
string<date-time>
required

When the trust was last updated

tax_id
string | null

Tax ID

Example:

"12-3456789"

additional_info
string | null

Additional information