---
title: >-
  The Customer resource now includes two new properties to save customer
  subscription states - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/the-customer-resource-now-includes-two-new-properties-to-save-customer-subscription-states
  md: >-
    https://shopify.dev/changelog/the-customer-resource-now-includes-two-new-properties-to-save-customer-subscription-states.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2019-03-11T17:59:48-04:00'
  postedAt: '2019-03-12T00:00:00-04:00'
  updatedAt: '2024-02-02T10:04:53-05:00'
  effectiveAt: '2019-03-12T00:00:00-04:00'
---

March 12, 2019

Tags:

* API

# The Customer resource now includes two new properties to save customer subscription states

We’ve introduced two new properties to the Customer REST resource to allow you to save the marketing subscription data you have about a merchant's customers to Shopify.

***

* `accepts_marketing_updated_at`: The date and time (ISO 8601 format) used to indicate when the customer was transitioned into the its current `accepts_marketing` state. Set this value when the customer subscribes to marketing materials.
* `marketing_opt_in_level`: Indicates the level of consent provided by a customer that accepts marketing. Valid values are `single_opt_in`, `confirmed_opt_in`, or `unknown`. If the customer does not accept marketing, then this property returns `null`.

These two properties are part of a continued effort to enable our partners to maintain the integrity of merchant's customer data. To learn more about these two news fields, see our [Customer API reference documentation](https://help.shopify.com/en/api/reference/customers/customer). We're expecting to release these two new properties in our Admin GraphQL API in the coming weeks.

If you have any questions about this update, then contact support through your [partner dashboard](https://partners.shopify.com/current/support/form) or request support in our [Shopify APIs and SDKs discussion board](https://community.shopify.com/c/Shopify-APIs-SDKs/bd-p/shopify-apis-and-technology).