Create a subscription transaction

POST/portfolio/transactions/subscriptions

portfolio:write portfolio_subscription_store

Creates a subscription transaction and associated cash flows for the investor. The subscription type (drawdown, units assigned, or fully paid up) is determined automatically from the target asset's configuration. If the investor does not yet exist in Horizon, a user record is created first.

Request body

application/json, required · PortfolioCreateSubscriptionRequest

asset_idintegerRequired#
sourcestring#
source_idstring#
investor_idstringRequired#
totalnumberRequired#
feenumber#
invoice_datestring (date-time)Required#
settlement_datestring (date-time)#
descriptionstring | null#
unitsnumber#
Required if asset is subscription type units_assigned or fully_paid_up
price_per_unitnumber#
Required if asset is subscription type units_assigned or fully_paid_up

{
  "asset_id": 1,
  "source": "string",
  "source_id": "string",
  "investor_id": "string",
  "total": 1,
  "fee": 1,
  "invoice_date": "2026-06-12T10:00:00+00:00",
  "settlement_date": "2026-06-12T10:00:00+00:00",
  "description": "string",
  "units": 1,
  "price_per_unit": 1
}

Responses

200

TransactionResource

PortfolioTransactionResource

{
  "data": {
    "id": 1,
    "type": "string",
    "guid": "string",
    "created_at": "string"
  }
}

422

Validation error

Examples

curl -X POST https://your-org-domain/kong/core/api/v2/portfolio/transactions/subscriptions\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"\
  -d '{
  "asset_id": 1,
  "source": "string",
  "source_id": "string",
  "investor_id": "string",
  "total": 1,
  "fee": 1,
  "invoice_date": "2026-06-12T10:00:00+00:00",
  "settlement_date": "2026-06-12T10:00:00+00:00",
  "description": "string",
  "units": 1,
  "price_per_unit": 1
}'