Choose a version:

Anchor to giftCardSendNotificationToCustomer

giftCardSendNotificationToCustomer

mutation

Requires write_gift_cards access scope.

Sends a gift card notification. If the gift card has a designated recipient, a purchase confirmation is sent instead. Both default email templates include the gift card code.

By default, gift card notifications use the linked order's contact details, with the assigned customer's details as a fallback. Purchase confirmations use the assigned customer's contact details.

The gift card must have an assigned customer with an email address or phone number. Returns an error without sending if the selected contact source has no contact information. When both an email address and a phone number are available, the notification is sent by email.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The ID of the gift card to send.

Was this section helpful?

Anchor to GiftCardSendNotificationToCustomerPayload returnsGiftCardSendNotificationToCustomerPayload returns

Anchor to giftCardgiftCard •GiftCard: The gift card that was sent.

Show fields
Anchor to userErrorsuserErrors •[GiftCardSendNotificationToCustomerUserError!]! non-null: The list of errors that occurred from executing the mutation.

Show fields

Was this section helpful?

Examples

Send a notification to a gift card's customer

Query

mutation giftCardSendNotificationToCustomer($id: ID!) {
  giftCardSendNotificationToCustomer(id: $id) {
    giftCard {
      id
      customer {
        id
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}

Variables

{
  "id": "gid://shopify/GiftCard/698360200"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation giftCardSendNotificationToCustomer($id: ID!) { giftCardSendNotificationToCustomer(id: $id) { giftCard { id customer { id } } userErrors { message field code } } }",
 "variables": {
    "id": "gid://shopify/GiftCard/698360200"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation giftCardSendNotificationToCustomer($id: ID!) {
    giftCardSendNotificationToCustomer(id: $id) {
      giftCard {
        id
        customer {
          id
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/GiftCard/698360200"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation giftCardSendNotificationToCustomer($id: ID!) {
    giftCardSendNotificationToCustomer(id: $id) {
      giftCard {
        id
        customer {
          id
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/GiftCard/698360200"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation giftCardSendNotificationToCustomer($id: ID!) {
      giftCardSendNotificationToCustomer(id: $id) {
        giftCard {
          id
          customer {
            id
          }
        }
        userErrors {
          message
          field
          code
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/GiftCard/698360200"
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation giftCardSendNotificationToCustomer($id: ID!) {
  giftCardSendNotificationToCustomer(id: $id) {
    giftCard {
      id
      customer {
        id
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/GiftCard/698360200"
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-10/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation giftCardSendNotificationToCustomer($id: ID!) {
        giftCardSendNotificationToCustomer(id: $id) {
          giftCard {
            id
            customer {
              id
            }
          }
          userErrors {
            message
            field
            code
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/GiftCard/698360200"
    },
  }),
});

const { data } = await response.json();
console.log(data);

Response

{
  "giftCardSendNotificationToCustomer": {
    "giftCard": {
      "id": "gid://shopify/GiftCard/698360200",
      "customer": {
        "id": "gid://shopify/Customer/649509010"
      }
    },
    "userErrors": []
  }
}

giftCardSendNotificationToCustomer reference

Examples

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation giftCardSendNotificationToCustomer($id: ID!) {

giftCardSendNotificationToCustomer(id: $id) {

giftCard {

customer {

}

userErrors {

message

field

code

}

}`,

{

variables: {

"id": "gid://shopify/GiftCard/698360200"

);

const json = await response.json();

return json.data;

}

GQL

mutation giftCardSendNotificationToCustomer($id: ID!) {
  giftCardSendNotificationToCustomer(id: $id) {
    giftCard {
      id
      customer {
        id
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation giftCardSendNotificationToCustomer($id: ID!) { giftCardSendNotificationToCustomer(id: $id) { giftCard { id customer { id } } userErrors { message field code } } }",
 "variables": {
    "id": "gid://shopify/GiftCard/698360200"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation giftCardSendNotificationToCustomer($id: ID!) {
    giftCardSendNotificationToCustomer(id: $id) {
      giftCard {
        id
        customer {
          id
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/GiftCard/698360200"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation giftCardSendNotificationToCustomer($id: ID!) {
      giftCardSendNotificationToCustomer(id: $id) {
        giftCard {
          id
          customer {
            id
          }
        }
        userErrors {
          message
          field
          code
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/GiftCard/698360200"
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation giftCardSendNotificationToCustomer($id: ID!) {
    giftCardSendNotificationToCustomer(id: $id) {
      giftCard {
        id
        customer {
          id
        }
      }
      userErrors {
        message
        field
        code
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/GiftCard/698360200"
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation giftCardSendNotificationToCustomer($id: ID!) {
  giftCardSendNotificationToCustomer(id: $id) {
    giftCard {
      id
      customer {
        id
      }
    }
    userErrors {
      message
      field
      code
    }
  }
}' \
--variables \
'{
  "id": "gid://shopify/GiftCard/698360200"
}'

Direct API Access

const response = await fetch('shopify:admin/api/2026-10/graphql.json', {
  method: 'POST',
  body: JSON.stringify({
    query: `
      mutation giftCardSendNotificationToCustomer($id: ID!) {
        giftCardSendNotificationToCustomer(id: $id) {
          giftCard {
            id
            customer {
              id
            }
          }
          userErrors {
            message
            field
            code
          }
        }
      }
    `,
    variables: {
        "id": "gid://shopify/GiftCard/698360200"
    },
  }),
});

const { data } = await response.json();
console.log(data);

Input variables

JSON

{

"id": "gid://shopify/GiftCard/698360200"

}

Response

JSON

{

"giftCardSendNotificationToCustomer": {

"giftCard": {

"id": "gid://shopify/GiftCard/698360200",

"customer": {

"id": "gid://shopify/Customer/649509010"

}

"userErrors": []

}