FeaturesCorporate ActionsSave Equity Compensation and Convertibles

Save Equity Compensation and Convertibles

Use this page when you need to save an equity compensation or convertible issuance through the API.

Before you use these routes

  • keep your issuer, stakeholder, and stock class IDs ready
  • equity compensation usually also needs a stock plan
  • some workflows also depend on vesting terms or valuation data

These routes save the issuance for later use. They do not create a history row.

Issue equity compensation

Use POST /transactions/issuance/equity-compensation to save an option, RSU, or SAR issuance.

{
    "issuerId": "<YOUR_ISSUER_ID>",
    "data": {
        "stakeholder_id": "<YOUR_STAKEHOLDER_ID>",
        "stock_plan_id": "<YOUR_STOCK_PLAN_ID>",
        "stock_class_id": "<YOUR_STOCK_CLASS_ID>",
        "compensation_type": "OPTION_NSO",
        "quantity": "10000",
        "exercise_price": {
            "amount": "1.00",
            "currency": "USD"
        },
        "expiration_date": "2036-01-01",
        "termination_exercise_windows": [
            {
                "reason": "VOLUNTARY_OTHER",
                "period": 90,
                "period_type": "DAYS"
            }
        ],
        "custom_id": "OPTION-001",
        "security_law_exemptions": [],
        "comments": []
    }
}

The response returns { "equityCompensationIssuance": ... }.

  • Required fields:

    • compensation_type
    • quantity
    • expiration_date
    • termination_exercise_windows

Options require exercise_price. SARs require base_price.

Issue a convertible

Use POST /transactions/issuance/convertible to save a SAFE, note, or other convertible issuance.

{
    "issuerId": "<YOUR_ISSUER_ID>",
    "data": {
        "stakeholder_id": "<YOUR_STAKEHOLDER_ID>",
        "convertible_type": "SAFE",
        "investment_amount": {
            "amount": "250000",
            "currency": "USD"
        },
        "conversion_triggers": [
            {
                "trigger_id": "SAFE-TRIGGER-001",
                "type": "UNSPECIFIED",
                "conversion_right": {
                    "type": "CONVERTIBLE_CONVERSION_RIGHT",
                    "conversion_mechanism": {
                        "type": "SAFE_CONVERSION",
                        "conversion_mfn": false,
                        "conversion_valuation_cap": {
                            "amount": "10000000",
                            "currency": "USD"
                        },
                        "conversion_discount": "0.2"
                    },
                    "converts_to_future_round": true
                }
            }
        ],
        "seniority": 1,
        "custom_id": "SAFE-001",
        "security_law_exemptions": [],
        "comments": []
    }
}

The response returns { "convertibleIssuance": ... }.

  • Required fields:

    • convertible_type
    • investment_amount
    • conversion_triggers
    • seniority

Verify the result

  • keep the returned equityCompensationIssuance or convertibleIssuance object
  • read the related stock plan, vesting terms, or valuation back if the issuance depends on those inputs
  • do not expect either route to appear in View History

What’s next?

Use Save Valuations and Terms for the supporting records around these issuances.

Transfer, Cancel, and Reissue StockSave Valuations and Terms