{"_id":"5908c9d0192e1b0f0036ff51","initVersion":{"_id":"58112e71ded0340f0085d02a","version":"2.0"},"project":"551e85be610f400d00837db7","user":{"_id":"58a36246b2c9e91b00e551cb","username":"","name":"Emily Brodman"},"__v":0,"createdAt":"2017-05-02T18:02:56.056Z","changelog":[],"body":"You'l find new resources associated with [subscription](http://docs.cratejoy.com/docs/subscription) objects: products, product instances, and gift information.\n\n## PRODUCTS AND PRODUCT INSTANCES\nNow it’s easy to see at scale what product a customer is subscribed to if your store has multiple subscription products. Note that if your subscription product has multiple variants, you will also want to use the `instance` object as well, as each possible combination of variants has a unique `product_instance_id`.\n\nWant more details on products, product instances, and how they map to subscriptions? [Check out this relationship map](http://docs.cratejoy.com/docs/customers-to-orders-subs-shipments), and check out the [product documentation](http://docs.cratejoy.com/docs/product).\n\n\n## SUBSCRIPTION GIFT INFO\nCratejoy sellers on our latest version of Gifting can start capturing a gift recipient’s name, email address, and gift message — and of course, we wanted to make that available to you via our API.\n\nNow, if a subscription is purchased as a gift, we’ll attach `subscription_gift_info` as a resource to the `subscription`, which has various pieces of information about the gift recipient and the gift sender — including the gift recipient’s contact information.\n\nNote that gift recipient in this case isn’t created as a brand new customer; instead, the subscription purchased still treats the gift sender as the customer, and has the gift recipient’s information attached to the subscription as extra data.\n\nFor more on subscription gift info via the API, check out our [Subscription Gift Info documentation](http://docs.cratejoy.com/v2.0/docs/subscription-gift-info) and for more on Gifting in Cratejoy, check out [our standard help center.](https://help.cratejoy.com/hc/en-us/articles/115002051626-Gifting-3-1-FAQ-s)","slug":"merchant-api-release-notes-may-2","title":"Merchant API Release Notes, May 2"}

Merchant API Release Notes, May 2


You'l find new resources associated with [subscription](http://docs.cratejoy.com/docs/subscription) objects: products, product instances, and gift information. ## PRODUCTS AND PRODUCT INSTANCES Now it’s easy to see at scale what product a customer is subscribed to if your store has multiple subscription products. Note that if your subscription product has multiple variants, you will also want to use the `instance` object as well, as each possible combination of variants has a unique `product_instance_id`. Want more details on products, product instances, and how they map to subscriptions? [Check out this relationship map](http://docs.cratejoy.com/docs/customers-to-orders-subs-shipments), and check out the [product documentation](http://docs.cratejoy.com/docs/product). ## SUBSCRIPTION GIFT INFO Cratejoy sellers on our latest version of Gifting can start capturing a gift recipient’s name, email address, and gift message — and of course, we wanted to make that available to you via our API. Now, if a subscription is purchased as a gift, we’ll attach `subscription_gift_info` as a resource to the `subscription`, which has various pieces of information about the gift recipient and the gift sender — including the gift recipient’s contact information. Note that gift recipient in this case isn’t created as a brand new customer; instead, the subscription purchased still treats the gift sender as the customer, and has the gift recipient’s information attached to the subscription as extra data. For more on subscription gift info via the API, check out our [Subscription Gift Info documentation](http://docs.cratejoy.com/v2.0/docs/subscription-gift-info) and for more on Gifting in Cratejoy, check out [our standard help center.](https://help.cratejoy.com/hc/en-us/articles/115002051626-Gifting-3-1-FAQ-s)