Shopistuff icon

Shopistuff

Consume Shopify API

Overview

The Shopistuff node for n8n enables integration with the Shopify API, specifically allowing you to manage customers.
For the Customer → Create operation, this node creates a new customer in your Shopify store using the provided details such as email, name, phone, addresses, and more.

Common scenarios:

  • Automating customer onboarding from web forms or CRM systems into Shopify.
  • Batch importing customer lists into Shopify.
  • Creating customers as part of order processing workflows.

Practical example:
When a user signs up on your website, their information can be automatically sent to Shopify to create a new customer record, ensuring your e-commerce platform stays in sync with your user base.


Properties

Name Type Meaning
Email String The customer's email address. Required for creating a customer.
First Name String The customer's first name.
Last Name String The customer's last name.
Phone String The customer's phone number.
Tags String Comma-separated tags to help categorize the customer.
Verified Email Boolean Indicates if the email is verified. Defaults to true.
Addresses Collection List of addresses associated with the customer. Each address includes:
- Address 1 (String): Street address
- City (String)
- Province (String)
- Phone (String)
- Zip (String): Postal code
- Last Name (String)
- First Name (String)
- Country (String)
Password String The password for the customer account (if applicable).
Password Confirmation String Confirmation of the password.
Send Email Welcome Boolean Whether to send a welcome email to the customer upon creation. Defaults to false.

Output

The output will be a JSON object representing the newly created customer as returned by the Shopify API.
Typical fields include (but are not limited to):

{
  "id": 123456789,
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1234567890",
  "tags": "VIP,Newsletter",
  "verified_email": true,
  "addresses": [
    {
      "address1": "123 Main St",
      "city": "Metropolis",
      "province": "State",
      "country": "Country",
      "zip": "12345",
      "phone": "+1234567890",
      "first_name": "John",
      "last_name": "Doe"
    }
  ],
  ...
}
  • The actual structure may contain additional fields as defined by Shopify's Customer API.
  • If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Dependencies

  • External Service: Requires access to a Shopify store and valid API credentials.
  • n8n Credentials: You must configure the shopistuffApi credential in n8n with your Shopify API key and password.

Troubleshooting

Common issues:

  • Missing required fields: If the "Email" property is not provided, the node will fail to create a customer.
  • Invalid email format: Shopify may reject improperly formatted emails.
  • Duplicate email: Attempting to create a customer with an email that already exists in Shopify will result in an error.
  • API authentication errors: Invalid or missing API credentials will cause authentication failures.

Error messages:

  • "At least one line item has to be added" – Not relevant for customer creation, but may appear if misconfigured.
  • Shopify API errors (e.g., "Email has already been taken", "Password confirmation doesn't match Password") will be passed through in the error field if "Continue On Fail" is enabled.

How to resolve:

  • Ensure all required fields are filled.
  • Double-check email formatting.
  • Use unique emails for each customer.
  • Verify your Shopify API credentials in n8n.

Links and References

Discussion