---
title: CustomerMarketingConsent - GraphQL Admin
description: >-
  The marketing consent information for a

  [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)

  on a specific marketing channel. Channel-specific types like
  [`CustomerWhatsAppMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent)

  implement this interface.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent.md
api_name: admin
api_type: graphql
type: interface
---

# Customer​Marketing​Consent

interface

Requires `read_customers` access scope.

The marketing consent information for a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) on a specific marketing channel. Channel-specific types like [`CustomerWhatsAppMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent) implement this interface.

## Fields

* collected​From

  [Customer​Consent​Collected​From](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerConsentCollectedFrom)

  The [source](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerConsentCollectedFrom) from which the marketing consent was collected.

* opt​In​Level

  [Customer​Marketing​Opt​In​Level](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingOptInLevel)

  The [marketing subscription opt-in level](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingOptInLevel) that was set when the customer's marketing consent was last updated. Follows M3AAWG best practices guidelines.

* source​Location

  [Location](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location)

  The [location](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) where the customer consented to receive marketing material.

* state

  [Customer​Marketing​Consent​State!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingConsentState)

  non-null

  The customer's current [marketing consent state](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingConsentState) for this channel.

* updated​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  The date and time when the marketing consent was updated.

  No date is provided if the customer has never updated their marketing consent for this channel.

***

##### Variables

```json
{
	"collectedFrom": "",
	"optInLevel": "",
	"sourceLocation": "",
	"state": "",
	"updatedAt": ""
}
```

##### Schema

```graphql
interface CustomerMarketingConsent {
  collectedFrom: CustomerConsentCollectedFrom
  optInLevel: CustomerMarketingOptInLevel
  sourceLocation: Location
  state: CustomerMarketingConsentState!
  updatedAt: DateTime
}
```