{"_id":"58e56ec8b9d1160f002553e3","user":{"_id":"58a36246b2c9e91b00e551cb","username":"","name":"Emily Brodman"},"__v":0,"initVersion":{"_id":"58112e71ded0340f0085d02a","version":"2.0"},"project":"551e85be610f400d00837db7","createdAt":"2017-04-05T22:25:12.002Z","changelog":[],"body":"## New: Apply or remove subscription coupons\n\nNew endpoints! We now have three new endpoints for subscriptions related to subscription coupons. \n\n**What are subscription coupons?** Subscription coupons are ordinary Cratejoy coupons that can be applied to subscriptions (active, cancelled, expired, whatever) that take effect whenever the subscription renews next, or after a cancelled/expired subscription is reactivated.\n\n**Why would I use subscription coupons?** Pre-applying a discount to a subscription can be a really effective way to keep customers happy, or to bring back cancelled or expired subscribers. It's like a reactivation or retention email campaign on steroids -- rather than just sending out a reactivation coupon to expired subscribers, you can\n1. Apply subscription coupons in bulk automatically, and then \n2. Email those expired subscribers to tell them that a discount will take effect if they reactivate their subscriptions! No need for those subscribers to remember the coupon code. \n\n**Sold. Tell me more.** For more information, check out [the new endpoints](http://docs.cratejoy.com/docs/subscription-methods#listing-adding-and-removing-subscription-coupons) and [more details on subscription coupons](http://docs.cratejoy.com/v2.0/docs/subscription-coupons).\n\n\n\n\n## Fixed: Filter on Customer Metadata\nWe'd had an issue where filtering on properties of customer metadata. It's now been resolved, meaning you can filter on `_md.created_at` or `_md.updated_at`, not just the data blob in `_md.data` when using the customer endpoint. For more on using customer metadata check out the [customer methods resource](http://docs.cratejoy.com/docs/methods-customer#section-customer-metadata) or the [customer metadata subresource](http://docs.cratejoy.com/v2.0/docs/customer-metadata).","slug":"merchant-api-release-notes-april-5","title":"Merchant API Release Notes, April 5"}

Merchant API Release Notes, April 5


## New: Apply or remove subscription coupons New endpoints! We now have three new endpoints for subscriptions related to subscription coupons. **What are subscription coupons?** Subscription coupons are ordinary Cratejoy coupons that can be applied to subscriptions (active, cancelled, expired, whatever) that take effect whenever the subscription renews next, or after a cancelled/expired subscription is reactivated. **Why would I use subscription coupons?** Pre-applying a discount to a subscription can be a really effective way to keep customers happy, or to bring back cancelled or expired subscribers. It's like a reactivation or retention email campaign on steroids -- rather than just sending out a reactivation coupon to expired subscribers, you can 1. Apply subscription coupons in bulk automatically, and then 2. Email those expired subscribers to tell them that a discount will take effect if they reactivate their subscriptions! No need for those subscribers to remember the coupon code. **Sold. Tell me more.** For more information, check out [the new endpoints](http://docs.cratejoy.com/docs/subscription-methods#listing-adding-and-removing-subscription-coupons) and [more details on subscription coupons](http://docs.cratejoy.com/v2.0/docs/subscription-coupons). ## Fixed: Filter on Customer Metadata We'd had an issue where filtering on properties of customer metadata. It's now been resolved, meaning you can filter on `_md.created_at` or `_md.updated_at`, not just the data blob in `_md.data` when using the customer endpoint. For more on using customer metadata check out the [customer methods resource](http://docs.cratejoy.com/docs/methods-customer#section-customer-metadata) or the [customer metadata subresource](http://docs.cratejoy.com/v2.0/docs/customer-metadata).