Sync Address in Recharge When a New Shopify Customer is Created

This scheduled trigger runs once per day at 8 AM. The morning timing provides coverage of the previous day's new customers and processes them before subscription charges typically run later in the day.

Customization: You can adjust the schedule to run at different times or more frequently (like "@hourly" for immediate sync) if new customer address synchronization needs to be more real-time.

This step fetches Shopify customers using time-based filtering. The query includes updated_at_min set to 24 hours ago (calculated using date math that subtracts 1 day from current time) and limit of 250 customers. This returns customers created in the past day who may have started subscriptions requiring address synchronization. The 250 limit is Shopify's maximum per request—if you have more than 250 new customers daily, you'd need pagination logic.

Why updated_at_min not created_at_min: The query uses updated_at_min because newly created customers have their updated_at timestamp set to creation time, so this effectively captures new customers while also catching any immediate updates they make.

This filter checks if the customer array is not empty. If true (customers exist), the workflow proceeds. If false (no new customers), the workflow stops here. This is especially useful for days with no new signups where running the full workflow would be wasteful.

This loop iterates through each customer in the array from step 2. For every customer, the loop executes the subsequent Recharge lookup, address retrieval, comparison, and update steps. This per-customer processing ensures one customer's sync failure doesn't prevent other customers from updating.

This step queries Recharge's customer database using the Shopify customer ID as the external_customer_id parameter. It returns matching Recharge customer records with the Recharge customer ID needed for address retrieval. The first result (index 0) contains the customer's Recharge data.

New customer timing: For this workflow to find customers in Recharge, they must have already created a subscription. If a customer signs up in Shopify but hasn't subscribed yet, the Recharge lookup returns empty and the workflow skips them (which is correct behavior).

This step queries Recharge for addresses belonging to the Recharge customer ID. It returns address records including address1, address2, city, province, zip, country_code, phone, and name fields. The first address (index 0) is used for comparison—this is typically the customer's primary subscription shipping address set during subscription creation.

New subscriber context: When customers create subscriptions, Recharge copies their Shopify address. However, timing issues or manual Recharge entry can create discrepancies this workflow corrects.

This filter implements comprehensive address comparison using OR logic. The workflow proceeds if ANY of these fields differ between Recharge and Shopify:

1. address1: Primary address line (street address, P.O. box)
2. address2: Secondary address line (apartment, suite, unit)
3. city: City name
4. province: State/province
5. zip: Postal code
6. country_code: Country code (like US, CA, GB)

OR logic reasoning: If even one field differs, the address needs updating. The OR operator ensures any discrepancy triggers synchronization, catching cases where Recharge didn't capture complete Shopify address data during subscription creation.

This step updates the Recharge address using the Recharge address ID. The update includes:

1. address1: Primary address line from Shopify default address
2. address2: Secondary address line from Shopify default address
3. city: City from Shopify default address
4. country: Country code from Shopify default address
5. customer_id: Recharge customer ID (maintains proper account association)
6. first_name: Customer's first name
7. last_name: Customer's last name
8. phone: Customer's phone from default address (or "No phone number provided" if missing)
9. zip: Postal code from Shopify default address
10. province: State/province from Shopify default address

Phone number handling: The workflow includes conditional logic that provides a fallback message if no phone number exists, preventing Recharge API errors from missing required phone fields.

The update ensures new subscribers have complete, accurate address information in Recharge from the start.