> ## 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 name="idempotencyKey" type="UUID!" required>
  A unique client generated UUID to ensure a request is processed only once.
</ParamField>

<ParamField name="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 name="spendLimitDuration" type="VirtualCardSpendLimitDuration">
  Card limit duration type. Default Lifetime.
</ParamField>

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

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

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

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

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

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

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

<ParamField name="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 name="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 name="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 name="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 name="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 name="memo" type="String">
  An optional note to attach to the transaction.
</ParamField>

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