Customer Import

Shopify customers are actively retrieved by Flowlyze.

The Adapter adds a tag to the customer to verify its export (EXPORTED) and avoid duplicate sends towards the destination, but only if the unique synchronization header is set to true. This behavior allows synchronizing a customer only once, ignoring any subsequent updates (optional behavior, configurable via header). If the header is not set, the tag is not added and the order can be exported multiple times.

warning

Compatibility with Shopify plans

Customer import is not supported for Shopify stores on Basic plan due to API limitations. To enable complete customer data import, it is necessary to upgrade to a higher plan.

Active Customer Flow Configuration

After creating the destination, proceed with flow insertion.

Campo	Valore	Note
Name	e.g. active-flow-customer	Scheduling name
Cron Expression	*/5 * * * *	How often to retrieve customers (e.g. */5 * * * * -> every 5 minutes)
Source Type	http	Source type to use
Url	https://adapt.flowlyze.com/api/adp/shopify/ingress/get-customers-updated-after	Endpoint URL to call (see note at end of table)
Method	GET	Method to call the endpoint
Headers :: x-api-key	**********	API key for endpoint interaction verification
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Shopify shop URL to connect to
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret of the custom app created for integration
Headers :: x-last-customer-updated-processed"	lastCustomerUpdatedProcessed	Date to start retrieving customers from, to be used with autoincremental
Headers :: x-sync-customer-once	true	Boolean to insert the customer only once, does not propagate updates (default false)
Headers :: channel-code"	Your Shopify Store	Your Shopify shop name or code
Headers :: x-number-of-customers	10	Number of customers to retrieve per call (default 10)

Example of retrieved information

{
    "id": "gid://shopify/Customer/6182841417961",
    "channel": "shopify",
    "email": "mario.bianchi@gmail.com",
    "createdAt": "2022-05-17T12:21:36+00:00",
    "updatedAt": "2025-04-28T12:38:28+00:00",
    "firstName": "Mario",
    "lastName": "Bianchi",
    "phone": "3345566767",
    "locale": "en-IT",
    "tags": [
      "tag1",
      "tag2"
    ],
    "acceptsEmailMarketing": false,
    "acceptsEmailMarketingDate": null,
    "acceptsSmsMarketing": false,
    "acceptsSmsMarketingDate": null,
    "totalSpent": 3728.03,
    "ordersCount": 27
}