Skip to main content
POST
This endpoint creates a new gift card that can be purchased or issued to customers. Gift cards support both physical and digital delivery, custom designs, and flexible redemption rules.

Authentication

This endpoint requires a valid API key with gift_cards:write permissions.

Request Body

string
required
Gift card type: “physical”, “digital”, “both”
integer
required
Initial balance in cents (e.g., 5000 for $50.00)
string
required
ISO 4217 currency code
object
Gift card recipient information
object
Gift card purchaser information
object
Gift card design customization
object
Gift card validity settings
object
Usage restrictions
string
Custom gift card code (auto-generated if not provided)
string
Associated order ID if purchased
object
Additional custom fields

Response

Returns the created gift card object.