Brand Help DocsShopify Flow Integration

Shopify Flow Handle Updated Trigger reference

CreatorCommerce provides real-time updates as affiliates create/change their collaboration handles. This is useful for updating redirects to drive any legacy affiliate links to redirect to the correct final shopping destination (the CreatorCommerce co-branded shopping experience).

What you’ll learn

Learn how to work with the Shopify Flow Handle Updated Trigger — an event that CreatorCommerce fires over to the Shopify Flow Shopify App. What is this trigger? It’s an indication of when a CreatorCommerce handle is created or changed for an affiliate. This handle is essential for your implementation of CreatorCommerce, as it represents the page handle for viewing the dedicated co-branded page for each affiliate.

Ideal use-cases for working with the Shopify Flow Handle Updated Trigger is to setup a URL redirect with the Admin API Action that redirects pre-existing affiliate links to the intended co-branded shopping destination. This end destination could be a shopping experience on the brand domain (brand.com/pages/creator/handle) or could be a shopping experience that’s hosted by CreatorCommerce (drops.shop/handle/brands/brand-handle).

Reminder: This functionality is available on the CreatorCommerce Pro Plan and up.

Shopify Flow 101

Shopify Flow enables brands to create tailored automations that streamline business operations, enhancing efficiency without requiring any hard coding skills. With Flow, you can build custom workflows effortlessly, freeing up more time to focus on scaling & operating. Top use-cases are to integrate apps to tackle more tasks, to automate inventory processes like reordering and restocking, to handle fraud management. Whatever the automation, Flow has the solution a majority of the time.

Flows are based on the concept of triggers, which begin workflows, and actions that fulfill the workflow.

Install or update Shopify Flow here - https://apps.shopify.com/flow

Accessing the Trigger

After installing CreatorCommerce and Shopify Flow, go into Shopify Flow and click to create a new workflow. When selecting a trigger, choose ‘CreatorCommerce’ > select ‘Handle Updated’.

CreatorCommerce Key Terms for the Shopify Handle Updated Trigger

creator - The affiliate behind the collaboration. Representing identifiable information like their name, onboarding status & unique ID. 

shop - Consumer-facing representation of how the collaboration is manifested. Is this a boutique? Recommendations? What accent colors are set to pull in if needed? Provided in the affiliate dashboard.

collab - Details about the collaboration pulled from connected affiliate platforms (Discount code, affiliate link, etc).

Handle Updated Trigger Structure

This trigger is fired when a handle is created or updated for a specific affiliate in the CreatorCommerce platform.

[INCLUDE IMAGE ON THE TRIGGER HERE]

Fields

creator.cc_first_name

Field type: Single line text

Contents: Creator’s first name from affiliate platform

creator.cc_last_name

Field type: Single line text

Contents: Creator’s last name from affiliate platform

creator.cc_new_shop_handle

Field type: Single line text

Contents: Creator’s new shop handle, a distinct key used for filtering for your creator. This key is referenced in all CreatorCommerce query parameters, cookies, and attributes.

creator.cc_old_shop_handle

Field type: Single line text

Contents: Creator’s old shop handle, a distinct key used for filtering for your creator. This key is referenced in all CreatorCommerce query parameters, cookies, and attributes.

creator.cc_is_onboarded

Field type: True or false

Contents: Boolean indication of if creator has made a drop before or not

creator.cc_relationship_manager

Field type: Single line text

Contents: The affiliate recruitment/tracking tool connected to the creator

creator.cc_discount_code

Field type: Single line text

Contents: The creator’s discount code for the connected relationship manager

creator.cc_affiliate_link

Field type: Single line text

Contents: The creator’s affiliate link for the connected relationship manager

creator.cc_tier_name

Field type: Single line text

Contents: The creator’s tier assignment in the relationship manager

Creating a Redirect Action with the Trigger

Use this trigger to set up redirects with legacy affiliate links to ensure your entire affiliate strategy is driving to the right destinations. Setup this specific action by pressing ‘Shopify’ > ‘Admin API’ > ‘Create URL Redirect’.

Using the fields in the trigger (outlined above) you can set up redirects that model the link structure of your affiliate platform so that pre-existing links redirect to the CreatorCommerce landing experience. Do this by referencing the variables from the tigger, to override any existing redirects. Reference a guide below to learn how to do this per supported affiliate platform.

How to setup redirects for Social Snowball links

How to setup redirect for Shopify Collabs link

Once the flow is live, make sure your CreatorCommerce pages are set up accordingly to either route to pages hosted on the brand website, or to route to pages hosted by CreatorCommerce.

Shopify Flow Integration