Skip to main content

Understanding Zest Gift Notes Events

Updated yesterday

Zest Gift Notes keeps track of gifter and recipient details and actions so you can send timely transactional emails, tracking updates, and marketing messages to both audiences (when they've opted in, of course).

When you connect your marketing tool to Zest, these events flow automatically — you're in full control of what you do with them on your end.

Events are automatically sent to your marketing tool the moment they happen. Use them to trigger automated email and SMS sequences for your gift-buying customers and their recipients. These events give you the critical information you need to send order confirmations and tracking updates, as well as personalized messages that keep gifters and recipients engaged all year long — so they come back to gift again!

Events

Order Placed

Event name: zest_gift_order_placed

Customer attached to the event: Gifter

This event fires when a customer places a gift order through your store. Use it to immediately confirm the order with the gifter and let them know their gift is on its way.

Example event data:

{   "order_id": "GFT-12345",   "customer_id": "cust_111111",   "customer_email": "[email protected]",   "customer_phone": "+13168371467",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_message": "Congratulations on your promotion! Enjoy this gift.",   "gift_from": "John Smith",   "digital_card": "https://your-store.com/images/congrats-card.png",   "digital_card_name": "Description of my digital card",   "digital_card_occasion": "Congratulations",   "recipient_name": "Jane Doe",   "recipient_email": "[email protected]",   "recipient_phone": "" }

Send Gift

Event name: zest_send_gift

Customer attached to the event: Gift recipient

This event fires when it's time to send the gift link to the recipient. The timing of this event automatically respects the gifter's selection — whether they chose to send the gift immediately, upon shipment, or upon delivery. You don't need to set up any additional timing logic in your workflows — Zest handles it for you.

Example event data:

{   "order_id": "GFT-12345",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_message": "Happy birthday! Hope you enjoy this little surprise.",   "gift_from": "Sarah Johnson",   "digital_card": "https://your-store.com/images/birthday-card.png",   "digital_card_name": "Description of my digital card",   "digital_card_occasion": "Birthday",   "recipient_name": "Michael Brown",   "recipient_email": "[email protected]",   "recipient_phone": "" }

Send Thank You

Event name: zest_send_thank_you

Customer attached to the event: Gifter

This event fires when a recipient writes a thank you message to the gift sender. Use it to delight the gifter with a notification and keep them engaged with your brand.

Example event data:

{   "order_id": "GFT-12345",   "customer_id": "cust_111111",   "customer_email": "[email protected]",   "customer_phone": "+13168371467",   "thank_you_message": "Thank you so much for the thoughtful gift! I love it!",   "recipient_name": "Emily Wilson" }

Tracking Opt-In (formerly: Gift Accepted)

Event name: zest_tracking_opt_in (formerly: zest_gift_accepted)

Customer attached to the event: Gift recipient

This event fires when a recipient opts in to receiving tracking information for their gift. Once a recipient opts in, they'll receive the shipping events below.

Note for existing users: If you were previously using zest_gift_accepted, that event name still fires alongside zest_tracking_opt_in. We recommend updating your workflows to use zest_tracking_opt_in going forward.

Example event data:

{   "order_id": "GFT-12345",   "recipient_customer_id": "cust_987654",   "recipient_email": "[email protected]",   "recipient_phone": "",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_from": "David Chen" }

Gift Shipped

Event name: zest_gift_shipped

Customer attached to the event: Gift recipient

This event fires when the gift order is marked as shipped. Only sent to recipients who have opted in to tracking. Use it to notify the recipient that their gift is on its way.

Example event data:

{   "order_id": "GFT-12345",   "recipient_customer_id": "cust_987654",   "recipient_email": "[email protected]",   "recipient_phone": "",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_from": "Alex Taylor",   "tracking_link": "https://tracking.carrier.com/1Z9999999999999999",   "tracking_number": "1Z9999999999999999",   "tracking_company": "UPS" }

Gift Out for Delivery

Event name: zest_gift_out_for_delivery

Customer attached to the event: Gift recipient

This event fires when the gift is out for delivery and will arrive at the recipient's address soon. Only sent to recipients who have opted in to tracking.

Example event data:

{   "order_id": "GFT-12345",   "recipient_customer_id": "cust_987654",   "recipient_email": "[email protected]",   "recipient_phone": "",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_from": "Jessica Miller",   "tracking_link": "https://tracking.carrier.com/1Z9999999999999999",   "tracking_number": "1Z9999999999999999",   "tracking_company": "FedEx" }

Gift Delivered

Event name: zest_gift_delivered

Customer attached to the event: Gift recipient

This event fires when the gift has been successfully delivered to the recipient. Only sent to recipients who have opted in to tracking. This is a great moment to trigger a personalized follow-up — the recipient just received something they love!

Example event data:

{   "order_id": "GFT-12345",   "recipient_customer_id": "cust_987654",   "recipient_email": "[email protected]",   "recipient_phone": "",   "gift_url": "https://your-store.com/apps/zest/gift/GFT-12345",   "gift_from": "Robert Wilson",   "tracking_link": "https://tracking.carrier.com/1Z9999999999999999",   "tracking_number": "1Z9999999999999999",   "tracking_company": "USPS" }
Did this answer your question?