# Opt in to a fund

> 🔒 **Private label — [contact sales](mailto:sales@boyahq.com).** Requires a private-label entitlement on your API client.

Opt in to a fund

Endpoint: POST /investments/opt-in
Version: 2.0.0
Security: oauth2ClientCredentials

## Header parameters:

  - `Idempotency-Key` (string)
    Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h.

  - `org_wallet_ref` (string)

  - `business_id` (string, required)

## Request fields (application/json):

  - `fund_id` (string, required)
    Catalogue fund id
    Example: fund_britam_kes_mmf

  - `amount` (number, required)
    Initial allocation, native currency
    Example: 100000

  - `currency` (string, required)
    Enum: "KES", "USD"

  - `accepted_terms` (boolean, required)
    Must be true
    Example: true

## Response 200 fields (application/json):

  - `fund_account_id` (string, required)
    Example: fa_01HXYZ...

  - `state` (string, required)
    Example: opt_in_pending

  - `message` (string, required)
    Example: opt-in approval requested