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

# Create Gift Card

> Create a new gift card

## Body Parameters

<ParamField body="initial_value" type="number" required>
  Gift card value in major currency units (e.g. `100` for \$100.00)
</ParamField>

<ParamField body="balance" type="number">
  Starting balance in major currency units (defaults to `initial_value`)
</ParamField>

<ParamField body="currency" type="string" default="USD">
  Currency code (ISO 4217)
</ParamField>

<ParamField body="code" type="string">
  Custom gift card code (auto-generated if not provided)
</ParamField>

<ParamField body="customer_id" type="string">
  Associate with a customer
</ParamField>

<ParamField body="note" type="string">
  Internal note
</ParamField>

<ParamField body="expires_on" type="string">
  Expiration date (ISO 8601)
</ParamField>

## Response

<ResponseExample>
  ```json theme={null}
  {
    "status": 201,
    "state": "success",
    "message": null,
    "data": {
      "gift_card": {
        "id": "5c1b8a7d-2e3f-4a9b-8c6d-1f2e3a4b5c6d",
        "gift_card_id": "5c1b8a7d-2e3f-4a9b-8c6d-1f2e3a4b5c6d",
        "code": "GIFT-WXYZ-5678-ABCD",
        "initial_value": 100,
        "balance": 100,
        "currency": "USD",
        "enabled": true,
        "disabled_at": null,
        "starts_at": "2024-01-20T14:30:00.000Z",
        "expires_on": "2025-06-15T00:00:00.000Z",
        "customer_id": "cust_xyz789",
        "order_id": null,
        "note": "Holiday promotion",
        "created_at": "2024-01-20T14:30:00.000Z",
        "updated_at": "2024-01-20T14:30:00.000Z"
      }
    }
  }
  ```
</ResponseExample>