9/29/2026, 12:00:54 AM
The giftCardSendNotificationToCustomer mutation now supports an optional contactSource enum that lets callers pick the source of the recipient’s contact details instead of relying purely on order or customer fallback defaults. If the selected source has no address or phone number, the mutation will return an error and no message is sent. The new GiftCardNotificationContactSource enum has two values—GIFT_CARD (assigned customer) and ORDER (linked order)—and defaults to order contacts with a customer fallback. The mutation’s description was clarified: a purchase‑confirmation is sent when a recipient is designated, otherwise a gift‑card notification is sent; in both cases the gift‑card code is included. The Rollout type now includes a schedule field exposing activateAt and optional concludeAt times, and its treatments list is guaranteed to include control treatments even when they have no changes. The RolloutSortKeys enum has been updated: CREATION_DATE and LAST_EDIT_DATE were removed, replaced by CREATED_AT and UPDATED_AT. Existing code may need to adjust to the new mutation signature, handle the new enum, and account for the updated sorting keys when querying rollouts.
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.
The contact source for gift card notifications and purchase confirmations.
When both an email address and a phone number are available, the notification is sent by email.
The planned activation and optional conclusion dates of a rollout, not its actual lifecycle timestamps.
scheduleThe rollout's planned activation and conclusion dates. Returns null when neither date is set.
treatmentsCREATION_DATELAST_EDIT_DATECREATED_ATUPDATED_AT