gift-card-issuance

Installation
SKILL.md

Purpose

Issues Shopify native gift cards to customers programmatically — as goodwill for a delayed shipment, as store credit instead of a cash refund, or as a loyalty reward. Uses Shopify's built-in gift card system; no 3rd-party app required. Gift cards issued here are redeemable at checkout exactly like manual gift cards. Note: giftCardCreate is available on all Shopify plans but may require the store to have gift cards enabled in settings. Replaces manual gift card creation in the Shopify admin and the store-credit features of returns/loyalty apps.

Prerequisites

  • shopify auth login --store <domain>
  • API scopes: read_customers, write_gift_cards
  • Gift cards must be enabled in Shopify admin → Settings → Gift cards

Parameters

Parameter Type Required Default Description
store string yes Store domain (e.g., mystore.myshopify.com)
format string no human Output format: human or json
dry_run bool no false Preview operations without executing mutations
customer_email string yes* Customer email to look up and associate with the gift card
customer_id string yes* Customer GID (alternative to email)
amount float yes Gift card value in the store's default currency
reason string no Internal note logged on the gift card (e.g., "Goodwill: delayed shipment #1042")
Related skills
Installs
2
GitHub Stars
139
First Seen
Apr 11, 2026