Skip to main content
POST
/
api
/
v1
/
gift_cards.json
Create Gift Card
curl --request POST \
  --url https://api.launchmystore.io/api/v1/gift_cards.json \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "initial_value": 123,
  "code": "<string>",
  "customer_id": "<string>",
  "note": "<string>",
  "expires_at": "<string>",
  "notify_customer": true
}
'
{
  "success": true,
  "data": {
    "id": "gc_new456",
    "code": "GIFT-WXYZ-5678-ABCD",
    "initial_value": 10000,
    "balance": 10000,
    "currency": "USD",
    "status": "enabled",
    "customer_id": "cust_xyz789",
    "expires_at": "2025-06-15T00:00:00Z",
    "created_at": "2024-01-20T14:30:00Z"
  }
}

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.

​
Body Parameters

​
initial_value
number
required
Gift card value in cents
​
code
string
Custom gift card code (auto-generated if not provided)
​
customer_id
string
Associate with a customer
​
note
string
Internal note
​
expires_at
string
Expiration date (ISO 8601)
​
notify_customer
boolean
default:"false"
Send gift card email to customer

​
Response

{
  "success": true,
  "data": {
    "id": "gc_new456",
    "code": "GIFT-WXYZ-5678-ABCD",
    "initial_value": 10000,
    "balance": 10000,
    "currency": "USD",
    "status": "enabled",
    "customer_id": "cust_xyz789",
    "expires_at": "2025-06-15T00:00:00Z",
    "created_at": "2024-01-20T14:30:00Z"
  }
}