> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateVirtualCardInput

> Input type for creating virtual cards.

**Input object**

Input type for creating virtual cards.

## Input fields

<ParamField body="idempotencyKey" type="UUID!" required>
  A unique client generated UUID to ensure a request is processed only once.
</ParamField>

<ParamField body="spendLimit" type="Float!" required>
  The maximum amount that you can charge to the card. You will only be charged for the amount you actually used.
</ParamField>

<ParamField body="spendLimitDuration" type="VirtualCardSpendLimitDuration">
  Card limit duration type. Default Lifetime.
</ParamField>

<ParamField body="lockDate" type="String">
  The date when the card will be locked. The default is 47 months.
</ParamField>

<ParamField body="lockCardNextUse" type="Boolean">
  The setting to lock the card after next use. The default is false.
</ParamField>

<ParamField body="cardNickname" type="String">
  The card's nickname.
</ParamField>

<ParamField body="primaryFundingSource" type="VirtualCardFundingSource">
  Primary Funding Source for Virtual Card.
</ParamField>

<ParamField body="bankAccountId" type="UUID">
  The unique identifier for the bank account.
</ParamField>

<ParamField body="offerId" type="UUID">
  The Offer Id of Virtual Card Offer. Use getVirtualCardOffers to fetch a list of active offers.
</ParamField>

<ParamField body="userCashBalanceId" type="UUID">
  The unique identifier of the user cash balance id
</ParamField>

<ParamField body="billingAddress" type="VirtualCardBillingAddressInput">
  A new billing address to register with the card program before issuing the card.
  A UserAddress (type: BILLING) is created if one does not already exist with the same
  street / city / state / postal code. Ignored when userAddressId is also provided.
</ParamField>

<ParamField body="userAddressId" type="UUID">
  An existing UserAddress ID belonging to the caller's account to use as the billing
  address. Takes precedence over billingAddress when both are provided.
</ParamField>

<ParamField body="usePrepaymentBalance" type="Boolean">
  When false, the card will not draw from the prepaid (gift card) balance.
  Defaults to true to preserve the existing behavior where the card may be funded
  by prepaid funds in addition to the specified spend account.
</ParamField>

<ParamField body="useRewardsBalance" type="Boolean">
  When false, the card will not draw from the rewards balance.
  Defaults to true to preserve the existing behavior where the card may be funded
  by rewards in addition to the specified spend account.
</ParamField>

<ParamField body="authUserId" type="UUID">
  Optional authorized user ID (UAC role assignment ID) to create the virtual card on
  behalf of. The assignment must exist on the caller's account and be ACTIVE.
  When provided, the downstream access token is issued for the underlying user so
  the resulting card is created on their behalf.
</ParamField>

<ParamField body="memo" type="String">
  An optional note to attach to the transaction.
</ParamField>

<ParamField body="transactionCategory" type="String">
  An optional category name. A matching category will be found or created for the account.
</ParamField>