---
title: CustomerMarketingConsentInput - GraphQL Admin
description: >-
  The input fields for marketing consent information when a

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

  consents to receive marketing material on a specific channel. Channel-specific

  consent mutations like
  [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate)

  use this input.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Customer​Marketing​Consent​Input

input\_object

The input fields for marketing consent information when a [customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) consents to receive marketing material on a specific channel. Channel-specific consent mutations like [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate) use this input.

## Fields

* 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 consented to receive marketing information.

* source​Location​Id

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

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

* state

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

  non-null

  The [marketing consent state](https://shopify.dev/docs/api/admin-graphql/latest/enums/CustomerMarketingConsentState) to set for the customer on this channel.

* updated​At

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

  The date and time when the customer consented to receive marketing material. If no date is provided, then the date and time when the consent information was sent is used.

***

## Input objects using this input

* [Customer​Input.whatsAppMarketingConsent](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerInput#fields-whatsAppMarketingConsent)

  INPUT OBJECT

  The input fields and values to use when creating or updating a customer.

* [Customer​Whats​App​Marketing​Consent​Update​Input.whatsAppMarketingConsent](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerWhatsAppMarketingConsentUpdateInput#fields-whatsAppMarketingConsent)

  INPUT OBJECT

  The input fields to update a customer's WhatsApp marketing consent information.

***

## Map

### Input objects using this input

* [Customer​Input.whatsAppMarketingConsent](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerInput#fields-whatsAppMarketingConsent)
* [Customer​Whats​App​Marketing​Consent​Update​Input.whatsAppMarketingConsent](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerWhatsAppMarketingConsentUpdateInput#fields-whatsAppMarketingConsent)
