Skip to main content

Customer Data Reference

Complete reference of all customer data attributes synced between Shopify and Brevo PushOwl, including marketing consent and custom metafields.

Written by Anand
Updated this week

This guide explains all the customer data that Brevo PushOwl syncs from your Shopify store.

Understanding these attributes helps you create targeted email and SMS campaigns.

Customer Properties Synced

Basic Information

Property

Description

Example

Email

Customer's email address

First Name

Customer's first name

John

Last Name

Customer's last name

Smith

Phone (SMS)

Customer's phone number for SMS

+1234567890

Company

Customer's company name

Acme Inc

Customer ID

Unique Shopify customer identifier

12345678

Shopify GID

Shopify's global ID for the customer

gid://shopify/Customer/12345678

Address Information

Property

Description

Example

Address Line 1

Primary street address

123 Main Street

Address Line 2

Apartment, suite, unit, etc.

Suite 456

City

Customer's city

New York

State/Province

State or province name

New York

Province Code

State/province code

NY

Country

Country name

United States

Country Code

ISO country code

US

ZIP/Postal Code

Postal or ZIP code

10001

Purchase History

Property

Description

Use Case

Order Count

Total number of orders placed

Target first-time vs. repeat buyers

Total Spent

Lifetime spending amount

Create VIP customer segments

Currency

Customer's preferred currency

Send pricing in their currency

Tax Exempt

Whether customer is tax exempt

B2B vs. B2C segmentation

Customer Engagement

Property

Description

Use Case

Tags

Shopify customer tags as comma-separated string (e.g., "VIP, Wholesale")

Segment by custom attributes

Shopify Customer Tags

Multiple choice tags for categorization

Create advanced segments

Note

Internal notes about the customer

Reference in support cases

Verified Email

Whether email has been verified

Target verified contacts only

Customer State

Account status (enabled/disabled)

Filter active customers

Marketing Consent

Property

Description

Sync Direction

Email Subscription Status

Whether customer accepts email marketing

Bi-directional (Shopify ↔ Brevo PushOwl)

SMS Subscription Status

Whether customer accepts SMS marketing

Bi-directional (Shopify ↔ Brevo PushOwl)

Timestamps

Property

Description

Shopify Creation Date

Original customer creation date on Shopify

Multi-Market Properties

If you use Shopify Markets for international selling:

Property

Description

Example

Locale

Customer's language preference

en-US, fr-FR, de-DE

Marketing Consent Explained

Configuring Consent Sync

You can configure how marketing consent syncs between Shopify and Brevo PushOwl from Settings → Synchronisation. On this page you can:

  • Choose the source of truth for marketing consent, either Shopify or Brevo

    • Choose Shopify if you have customers on Shopify and no contacts on Brevo

    • Choose Brevo if you have existing contacts on Brevo

  • Control the sync direction for marketing consent: configure which email and SMS subscription statuses sync from Shopify → Brevo and from Brevo → Shopify

  • Enable or disable reverse sync: toggle whether new contacts created in Brevo are automatically added to your Shopify store

How Consent Syncs

Brevo PushOwl maintains bi-directional sync for marketing consent:

Shopify to Brevo PushOwl:

  • When a customer subscribes or unsubscribes in Shopify, Brevo PushOwl is updated within seconds

  • The consent webhook updates email and SMS subscription status

Brevo PushOwl to Shopify:

  • When consent changes in Brevo PushOwl (via unsubscribe links, preferences), Shopify is updated

  • Email and SMS subscription status sync back automatically

Consent States

State

Meaning

Subscribed

Customer has opted in to receive marketing

Not Subscribed

Customer has not opted in (no action taken)

Unsubscribed

Customer previously subscribed but opted out

Pending

Awaiting confirmation (for double opt-in)

Double Opt-In (DOI)

For stores with double opt-in enabled:

  • Customers receive a confirmation email after subscribing

  • In Shopify, the consent status remains "Pending" until the customer confirms

  • In Brevo PushOwl, the contact is created as blocklisted until confirmation

  • Once the customer confirms, the status changes to "Subscribed" in both Shopify and Brevo PushOwl

For complete details on setting up and managing DOI, see our Double Opt-In (DOI) guide.

Custom Metafields (Advanced)

Brevo PushOwl can sync custom customer metafields from Shopify. This allows you to:

  • Sync loyalty points

  • Sync customer preferences

  • Sync custom attributes unique to your store

Supported metafield types:

  • Single line text

  • Number (decimal and integer)

  • Date and date/time

  • Boolean (true/false)

  • Category (single select values)

  • Multiple-choice (multiple values)

For setup instructions, see Attribute Mapping (Custom Metafields).

Customer Segmentation Ideas

By Purchase Behavior

  • First-time buyers: Order Count = 1

  • Repeat customers: Order Count > 1

  • VIP customers: Total Spent > $500

  • Lapsed customers: Last order > 90 days ago

By Location

  • Local customers: Country = United States, State = California

  • International customers: Country != United States

  • Specific locale: Locale = "fr-FR"

By Engagement

  • Verified contacts: Verified Email = true

  • Tagged customers: Tags contains "VIP"

  • SMS enabled: SMS Subscription = Subscribed

Sync Timing

Data Type

Sync Frequency

New customers

Near real-time

Customer updates

Near real-time

Marketing consent changes

Near real-time

Order count/total spent

Updated with each order

Managing Real-Time Sync

You can manage the real-time sync for each data type from Settings → Synchronisation. The Real-time Sync Status section shows the current sync status for each entity (Customers, Collections, Products, Product Variants, Orders) and allows you to stop or resume the real-time sync individually.

If you need to re-import your historical data, use the Resync button in the Historical Sync Status section on the same page.

Important Notes

  1. Customers vs. Contacts: Customers created directly in Brevo PushOwl (e.g., through sign-up forms) don't automatically sync back to Shopify as customers. To enable this feature, enable the Reverse Sync option in Settings → Synchronisation

  2. Deleted Customers: If you delete a customer in Shopify, they remain in Brevo PushOwl. You can manually remove them if needed. If you want them to remove automatically, please contact support.

  3. Phone Number Uniqueness: A phone number can only be attached to one contact in Brevo PushOwl. If two customers in Shopify share the same phone number, only the first customer will be synced with that number during historical sync. The second customer will sync in real-time but without the phone number.

  4. Phone Number Format: Phone numbers are normalized and include country codes for international SMS delivery.

  5. Tag Limits: Brevo PushOwl supports a maximum of 250 customer tags per contact.

Related Articles

Did this answer your question?