--- title: CustomerMarketingOptInLevel - GraphQL Admin description: |- The possible values for the marketing subscription opt-in level enabled at the time the customer consented to receive marketing information. The levels are defined by [the M3AAWG best practices guideline document](https://www.m3aawg.org/sites/maawg/files/news/M3AAWG_Senders_BCP_Ver3-2015-02.pdf). api_version: 2026-10 source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/enums/customermarketingoptinlevel md: https://shopify.dev/docs/api/admin-graphql/latest/enums/customermarketingoptinlevel.md --- # Customer​Marketing​Opt​In​Level enum The possible values for the marketing subscription opt-in level enabled at the time the customer consented to receive marketing information. The levels are defined by [the M3AAWG best practices guideline document](https://www.m3aawg.org/sites/maawg/files/news/M3AAWG_Senders_BCP_Ver3-2015-02.pdf). ## Valid values * CONFIRMED\_​OPT\_​IN After providing their information, the customer receives a confirmation and is required to perform a intermediate step before receiving marketing information. * SINGLE\_​OPT\_​IN After providing their information, the customer receives marketing information without any intermediate steps. * UNKNOWN The customer receives marketing information but how they were opted in is unknown. *** ## Fields * [Customer​Email​Address.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailAddress#field-CustomerEmailAddress.fields.marketingOptInLevel) OBJECT A customer's email address with marketing consent. This includes the email address, marketing subscription status, and opt-in level according to [M3AAWG best practices guidelines](https://www.m3aawg.org/news/updated-m3aawg-best-practices-for-senders-urge-opt-in-only-mailings-address-sender-transparency). It also provides the timestamp of when customers last updated marketing consent and URLs for unsubscribing from marketing emails or opting in or out of email open tracking. The [`sourceLocation`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailAddress#field-CustomerEmailAddress.fields.sourceLocation) field indicates where the customer consented to receive marketing material. * [Customer​Email​Marketing​Consent​Input.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerEmailMarketingConsentInput#fields-marketingOptInLevel) INPUT OBJECT Information that describes when a customer consented to receiving marketing material by email. * [Customer​Email​Marketing​Consent​State.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailMarketingConsentState#field-CustomerEmailMarketingConsentState.fields.marketingOptInLevel) OBJECT The record of when a customer consented to receive marketing material by email. * [Customer​Marketing​Consent.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent#fields-optInLevel) INTERFACE 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. * [Customer​Marketing​Consent​Input.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput#fields-optInLevel) 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. * [Customer​Sms​Marketing​Consent.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsent#field-CustomerSmsMarketingConsent.fields.optInLevel) OBJECT The SMS marketing consent information for a [customer's phone number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber). Implements the [`CustomerMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent) interface. Use the [`customerSmsMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSmsMarketingConsentUpdate) mutation to change it. * [Customer​Sms​Marketing​Consent​Input.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerSmsMarketingConsentInput#fields-marketingOptInLevel) INPUT OBJECT The marketing consent information when the customer consented to receiving marketing material by SMS. * [Customer​Sms​Marketing​Consent​State.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsentState#field-CustomerSmsMarketingConsentState.fields.marketingOptInLevel) OBJECT The record of when a customer consented to receive marketing material by SMS. The customer's consent state reflects the record with the most recent date when consent was updated. * [Customer​Whats​App​Marketing​Consent.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent#field-CustomerWhatsAppMarketingConsent.fields.optInLevel) OBJECT The WhatsApp marketing consent information for a [customer's phone number](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber). Implements the [`CustomerMarketingConsent`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/CustomerMarketingConsent) interface. Use the [`customerWhatsAppMarketingConsentUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerWhatsAppMarketingConsentUpdate) mutation to update it. * [Customer​Phone​Number.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerPhoneNumber#field-CustomerPhoneNumber.fields.marketingOptInLevel) OBJECT Deprecated *** ## Map ### Fields with this enum * [Customer​Email​Address.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailAddress#field-CustomerEmailAddress.fields.marketingOptInLevel) * [Customer​Email​Marketing​Consent​State.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerEmailMarketingConsentState#field-CustomerEmailMarketingConsentState.fields.marketingOptInLevel) * [Customer​Sms​Marketing​Consent.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsent#field-CustomerSmsMarketingConsent.fields.optInLevel) * [Customer​Sms​Marketing​Consent​State.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSmsMarketingConsentState#field-CustomerSmsMarketingConsentState.fields.marketingOptInLevel) * [Customer​Whats​App​Marketing​Consent.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerWhatsAppMarketingConsent#field-CustomerWhatsAppMarketingConsent.fields.optInLevel) ### Inputs with this enum * [Customer​Email​Marketing​Consent​Input.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerEmailMarketingConsentInput#fields-marketingOptInLevel) * [Customer​Marketing​Consent​Input.optInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerMarketingConsentInput#fields-optInLevel) * [Customer​Sms​Marketing​Consent​Input.marketingOptInLevel](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CustomerSmsMarketingConsentInput#fields-marketingOptInLevel)