Create a gift card via POST /admin/api/2024-01/gift_cards.json with initial_value (the dollar amount), currency, and optionally customer_id to associate it with a specific customer account
Retrieve the gift card code from the response; this is the only time the full code is returned in plaintext — store it securely or deliver it immediately to the recipient
To load a specific code (e.g., for bulk corporate gift card issuance), include the code field in the creation request with a pre-generated alphanumeric string
Retrieve gift card balance and status via GET /admin/api/2024-01/gift_cards/{gift_card_id}.json; the balance field shows the remaining value after any redemptions
Disable a lost or fraudulent gift card via POST /admin/api/2024-01/gift_cards/{gift_card_id}/disable.json to prevent further redemption
Search for a gift card by code (last 4 characters) using GET /admin/api/2024-01/gift_cards.json?status=enabled for lookup workflows at customer service
Known gotchas
The full gift card code is only returned at creation time; subsequent API reads return a masked version for security — there is no way to retrieve the full plaintext code again after creation
Gift cards in Shopify are treated as payment methods, not products, for accounting purposes; ensure your finance team accounts for gift card liabilities correctly at issuance
Shopify gift cards do not expire by default and are not subject to inactivity fees unless you implement expiry logic using the expires_on field at creation time
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp