Skip to main content
Create a new customer in the shop. Required Permission:
  • write_customers.
External DocumentationTo learn more, visit the Shopify documentation.

​
Basic Parameters

ParameterDescription
AddressesJSON array of address objects to set for the customer. All fields are optional.

For example:
[{
  “address1”: “Chestnut Street 92”,
  “address2”: “Apartment 2”,
  “city”: “Louisville”,
  “company”: null,
  “countryCode”: “US”,
  “firstName”: “Bob”,
  “lastName”: “Norman”,
  “phone”: “555-625-1199”,
  “provinceCode”: “QC”,
  “zip”: “40202”
}]
Note: For more information regarding the Addresses parameter, visit Shopify API documentation
Email AddressEmail address of the customer.
First NameFirst name for the customer.
Last NameLast name for the customer.
Phone NumberE.164 formatted phone number of the customer.

​
Advanced Parameters

ParameterDescription
Email Marketing ConsentInformation that describes when the customer consented to receiving marketing material by email.

Note: The Email Address parameter is required when creating a customer with email marketing consent information.
Email Marketing Consent Opt In LevelThe customer opt-in level at the time of subscribing to marketing material.

Note: The Email Marketing Consent parameter must be provided when using this parameter.
Email Marketing Consent Updated DateThe latest date and time when the customer consented or objected to receiving marketing material by email.

Note: The Email Marketing Consent parameter must be provided when using this parameter.
LocaleThe customer’s locale.
MetafieldsJSON array of additional Metafields to associate to the customer.

For example:
[{
  “namespace”: “my_field”,
  “key”: “nickname”,
  “type”: “single_line_text_field”,
  “value”: “rob”
}]
Note: For more information regarding the Metafields parameter, visit Shopify API documentation
NoteAn note to save on the customer.

For example:
Placed an order that had a fraud warning.
SMS Marketing ConsentThe marketing consent information when the customer consented to receiving marketing material by SMS.

Note: The Phone Number parameter is required when creating a customer with SMS marketing consent information.
SMS Marketing Consent Updated DateThe latest date and time when the customer consented or objected to receiving marketing material by SMS.

Note: The SMS Marketing Consent parameter must be provided when using this parameter.
SMS Marketing Opt In LevelThe marketing subscription opt-in level that was set when the customer consented to receive marketing information.

Note: The SMS Marketing Consent parameter must be provided when using this parameter.
TagsA comma-separated list of tags to add to this customer.

For example:
tag1,tag2,tag3
Tax ExemptWhen checked, the customer is exempt from paying taxes on their order.
Tax ExemptionsThe list of tax exemptions to apply to the customer.

Note: For more information about the Tax Exemptions parameter, visit Shopify API documentation

​
Example Output

{
  "customerCreate": {
    "userErrors": [],
    "customer": {
      "id": "gid://shopify/Customer/1073340090",
      "email": "steve.lastnameson@example.com",
      "phone": "+16465555555",
      "taxExempt": false,
      "emailMarketingConsent": {
        "marketingState": "SUBSCRIBED",
        "marketingOptInLevel": "CONFIRMED_OPT_IN",
        "consentUpdatedAt": "2024-11-05T14:29:06Z"
      },
      "firstName": "Steve",
      "lastName": "Lastname",
      "amountSpent": {
        "amount": "0.0",
        "currencyCode": "USD"
      },
      "smsMarketingConsent": {
        "marketingState": "NOT_SUBSCRIBED",
        "marketingOptInLevel": "SINGLE_OPT_IN"
      },
      "addresses": [
        {
          "address1": "412 fake st",
          "city": "Ottawa",
          "country": "Canada",
          "phone": "+16469999999",
          "zip": "A1A 4A1"
        }
      ]
    }

​
Workflow Library Example

Create Customer with Shopify and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop