Shopify Integration

Automatically create Shopify customers every time someone fills out your form — perfect for lead capture, newsletter signups, and pre-orders.

Field Mapping

email

customer.email(string)

name / first_name

customer.first_name(string)

last_name

customer.last_name(string)

phone

customer.phone(string)

address / city / country

customer.addresses[](object)

(other fields)

customer.note(text)

Prerequisites

A Shopify store (any plan — Starter, Basic, Shopify, Advanced, or Plus)
A Custom App with write_customers Admin API access scope
Your store's Admin API access token (starts with shpat_)

Setup

Create a Custom App in Shopify

In your Shopify admin, go to Settings → Apps and sales channels → Develop apps. If you haven't enabled custom app development, click "Allow custom app development". Then click "Create an app"and give it a name (e.g., "Flowqen Integration").

Configure API scopes

Click "Configure Admin API scopes". Search for and enable the write_customers scope. Click Save.

Install the app and get the access token

Click "Install app". After installation, go to API credentials and copy the Admin API access token. This token starts with shpat_.

Save your token

Shopify only shows the access token once. Copy it immediately and store it securely. If you lose it, you'll need to uninstall and reinstall the app.

Configure in Flowqen

Go to your form's Integrations tab. Click the Shopify card and:

Toggle "Enable Shopify integration" on
Enter your Store URL (e.g., mystore or mystore.myshopify.com)
Paste the Admin API access token
Set the Email field name if your form uses something other than "email"
Click Save

Shopify integration settings panel in Flowqen

Payload

POSThttps://{store}.myshopify.com/admin/api/2024-01/customers.json

Shopify Admin API — Create Customer

{
  "customer": {
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "verified_email": true,
    "send_email_welcome": false,
    "phone": "+1234567890",
    "addresses": [
      {
        "address1": "123 Main St",
        "city": "Toronto",
        "province": "Ontario",
        "country": "Canada",
        "zip": "M5V 2T6"
      }
    ],
    "note": "company: Acme Inc\ninterest: Premium plan"
  }
}

Smart Field Mapping

Flowqen automatically maps common form field names to Shopify customer properties:

Form field names	Shopify property
`email`	customer.email
`name`, `first_name`, `firstname`, `firstName`	customer.first_name
`last_name`, `lastname`, `lastName`	customer.last_name
`phone`, `telephone`, `mobile`	customer.phone
`address`, `address1`, `street`	addresses[0].address1
`city`	addresses[0].city
`state`, `province`	addresses[0].province
`country`	addresses[0].country
`zip`, `postal_code`, `zipcode`	addresses[0].zip
(all other fields)	customer.note

Good to know

Customer creation is fire-and-forget — it never delays or blocks the form submission.
If a customer with the same email already exists in Shopify, the API returns a 422 error which is silently handled.
Your access token is stored securely and never exposed to form submitters.
Fields not mapped to standard Shopify properties are added as a note on the customer record.
The name field is automatically split into first and last name.
Works with all Shopify plans including Starter, Basic, Shopify, Advanced, and Plus.