Use the Admin GraphQL giftCardCreate mutation with a GiftCardCreateInput specifying initialValue (as a decimal string in the store's currency), and optionally expiresOn, customerId, and note.
The mutation returns the gift card's id, lastCharacters (for display), and maskedCode; the full code is only returned at creation time—store it securely if you need to deliver it to the recipient.
To disable (deactivate) a gift card, call giftCardDisable with the gift card's ID; a disabled gift card cannot be used at checkout.
Query giftCard by ID to retrieve balance, expiresOn, and enabled status for customer service lookups.
To search for gift cards by code suffix, use the giftCards query with a query filter on lastCharacters.
Consult current Shopify docs for currency handling: gift card values are stored in the store's default currency, and multi-currency behavior at redemption is subject to current Shopify Markets rules.
Known gotchas
The full gift card code is only available in the giftCardCreate response; subsequent queries return only lastCharacters for security, so deliver the code to the recipient immediately after creation.
Disabling a gift card is irreversible via the API; re-enabling requires manual action in the Shopify admin; include a confirmation step before calling giftCardDisable.
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