Shopify gift card create via giftCardCreate and disabling a gift card

domain: shopify.dev · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Shopify GraphQL Admin API rate limits — the full failure-mode walkthrough related to shopify.dev, checked against official docs, with linked verified routes.

Steps

  1. 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.
  2. 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.
  3. To disable (deactivate) a gift card, call giftCardDisable with the gift card's ID; a disabled gift card cannot be used at checkout.
  4. Query giftCard by ID to retrieve balance, expiresOn, and enabled status for customer service lookups.
  5. To search for gift cards by code suffix, use the giftCards query with a query filter on lastCharacters.
  6. 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

Related routes

Issue and redeem Shopify gift cards programmatically via the Gift Cards API
shopify.com · 6 steps · unrated
Shopify gift card apply at checkout via Storefront API
shopify.dev · 6 steps · unrated
Sell, activate, and redeem a Square gift card using the Gift Cards API and Gift Card Activities API as a self-serve alternative to a webhook-based gift card partner integration
developer.squareup.com · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans