---
title: >-
  Improvements in the GiftCard GraphQL endpoints and introducing
  GiftCardTransaction types - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/improvements-in-the-giftcard-graphql-endpoints-and-introducing-giftcardtransaction-types
  md: >-
    https://shopify.dev/changelog/improvements-in-the-giftcard-graphql-endpoints-and-introducing-giftcardtransaction-types.md
metadata:
  effectiveApiVersion: 2024-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2024-09-11T13:47:42-04:00'
  postedAt: '2024-09-17T08:00:00-04:00'
  updatedAt: '2024-09-17T10:55:11-04:00'
  effectiveAt: '2024-09-17T08:00:00-04:00'
---

September 17, 2024

Tags:

* Action Required
* Admin GraphQL API
* 2024-10

# Improvements in the GiftCard GraphQL endpoints and introducing GiftCardTransaction types

As of the GraphQL Admin API version 2024-10, we're improving the `GiftCard` endpoints and introducing `GiftCardTransaction` types. The gift card endpoints are now open to all apps and shops, with no additional approval scopes or flags required.

We have added the following mutations:

* `giftCardDeactivate` renamed from `giftCardDisable` (deprecated).
* `giftCardCredit` to apply credit to a gift card returning a `GiftCardCreditTransaction`.
* `giftCardDebit` to apply debit to a gift card returning a `GiftCardDebitTransaction`.
* `giftCardSendNotificationToCustomer` to send the notification to the customer.
* `giftCardSendNotificationToRecipient` to send the notification to the recipient.

We have updated the following mutations:

* `giftCardCreate` to add `recipientAttributes`.
* `giftCardUpdate` to add `recipientAttributes`.

We have added and modified fields in the `GiftCard` object:

* Added `updatedAt`.
* Added `recipientAttributes`.
* Added `transactions` returning all transactions created by credits and debits.
* Renamed `disabledAt` to `deactivatedAt` (deprecated).

### Developer action required

Developers using the existing `giftCardDisable` mutation will need to replace it with `giftCardDeactivate`

Developers using the `disableAt` property on the `GiftCard` object will need to replace it with `deactivatedAt`

To learn more about gift cards, refer to the [gift cards](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/GiftCard) documentation. To learn more about gift card recipient functionality, refer to the help center documentation for [recipient fields](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/add-gift-card-recipient-fields)