Choose a version:

customerEmailMarketingSubscribe

mutation

Requires unauthenticated_write_customers access scope.

Subscribes a customer to the newsletter with an email address.

Arguments

Anchor to emailemail •String! required: The customer's email address.

Was this section helpful?

Anchor to CustomerEmailMarketingSubscribePayload returnsCustomerEmailMarketingSubscribePayload returns

Anchor to customercustomer •CustomerMarketingSubscribe: The created customer object.
Anchor to customerUserErrorscustomerUserErrors •[CustomerUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Subscribe a customer to your newsletter

Description

Subscribe a customer to your newsletter

Query

mutation customerEmailMarketingSubscribe($email: String!) {
  customerEmailMarketingSubscribe(email: $email) {
    customer {
      email
    }
    customerUserErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "email": "johnsmith@shopify.com"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "mutation customerEmailMarketingSubscribe($email: String!) { customerEmailMarketingSubscribe(email: $email) { customer { email } customerUserErrors { field message code } } }",
 "variables": {
    "email": "johnsmith@shopify.com"
  }
}'

Remix

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  mutation customerEmailMarketingSubscribe($email: String!) {
    customerEmailMarketingSubscribe(email: $email) {
      customer {
        email
      }
      customerUserErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "email": "johnsmith@shopify.com"
    },
  },
);

const data = await response.json();

Node.js

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: {
    "query": `mutation customerEmailMarketingSubscribe($email: String!) {
      customerEmailMarketingSubscribe(email: $email) {
        customer {
          email
        }
        customerUserErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "email": "johnsmith@shopify.com"
    },
  },
});

Response

{
  "customerEmailMarketingSubscribe": {
    "customer": {
      "email": "johnsmith@shopify.com"
    },
    "customerUserErrors": []
  }
}

customerEmailMarketingSubscribe reference

Examples

Open in GraphiQL

const { storefront } = await unauthenticated.storefront(

'your-development-store.myshopify.com'

);

const response = await storefront.graphql(

`#graphql

mutation customerEmailMarketingSubscribe($email: String!) {

customerEmailMarketingSubscribe(email: $email) {

customer {

}

customerUserErrors {

field

message

code

}

}`,

{

variables: {

"email": "johnsmith@shopify.com"

);

const data = await response.json();

mutation customerEmailMarketingSubscribe($email: String!) {
  customerEmailMarketingSubscribe(email: $email) {
    customer {
      email
    }
    customerUserErrors {
      field
      message
      code
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/api/unstable/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "mutation customerEmailMarketingSubscribe($email: String!) { customerEmailMarketingSubscribe(email: $email) { customer { email } customerUserErrors { field message code } } }",
 "variables": {
    "email": "johnsmith@shopify.com"
  }
}'

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  mutation customerEmailMarketingSubscribe($email: String!) {
    customerEmailMarketingSubscribe(email: $email) {
      customer {
        email
      }
      customerUserErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "email": "johnsmith@shopify.com"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: {
    "query": `mutation customerEmailMarketingSubscribe($email: String!) {
      customerEmailMarketingSubscribe(email: $email) {
        customer {
          email
        }
        customerUserErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "email": "johnsmith@shopify.com"
    },
  },
});

Input variables

JSON

{

"email": "johnsmith@shopify.com"

}

Response

JSON

{

"customerEmailMarketingSubscribe": {

"customer": {

"email": "johnsmith@shopify.com"

"customerUserErrors": []

}