> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Shopify Flow with custom triggers
Shopify Flow is an e-com automation platform that you can use to automate tasks and processes within your Shopify store and across your apps. Shopify Flow monitors your store for events and lets you create a sequence of actions that are taken in response. You can automate tasks and processes within your store and across your apps by creating workflows using triggers, conditions, and actions.
Using Shopify Flow's “Send HTTP request“ action, you can trigger a marketing automation in Engage and build user journeys based on the various customer activities in Shopify.
This example looks at how to synchronize selected customer tags from Shopify to Engage and link them to a contact. By configuring a custom trigger in Engage and invoking that trigger within Shopify Flow, you will be able to associate tags as labels in Engage.
## Configuration in Engage
Follow these steps:
Config Hub is found under **Administration** on the left-hand menu in Engage.
Go to the **Custom Triggers** page and create a new custom trigger with the values you need. For example:
* Name: “Gender - Shopify tags”
* TriggerId: “genderTags“
* Description: “Set gender labels in Voyado Engage“
To your new custom trigger, add a new field. For example:
* Name: “gender"
* Description: “Gender“
Pick the custom trigger you just created from the list of triggers
Add a value split in your automation
Input the expected values coming from Shopify Flow and select “Ok”.
Add a “Set label“ activity in each leg of the split
Now activate the automation.
## Configuration in Shopify
Follow these steps:
Create a new flow in Shopify Flow
Choose a trigger (for example: “Customer tags added”).
Add the action “Flow” > “Send HTTP Request“
Choose POST as the HTTP method.
Input the Request URL listed below in the URL field. Be sure to replace “\[tenantId]“ with the actual name of your tenant.
Add the request headers as shown in the section "Request headers" below. Remember to replace the value of *apikey* with your actual API key, which you can find via the [Config Hub](https://help.engage.voyado.com/hc/en-gb/articles/23405185859228-API-connections)
Add the body and loop through the tags you want to send over to Engage. Remember to change the name of the “gender“ field to something more relevant if you are syncing tags that are not related to this specific use-case.
### The request URL
This URL triggers the custom trigger endpoint by using the Shopify ID which is linked to the *externalId* field in Voyado Engage.
```http theme={null}
https://[tenantId].voyado.com/api/v2/automation/customTriggers/[TriggerId]/triggerByExternalContactId/{{customer.id | remove_first: "gid://shopify/Customer/"}}
```
Remember to replace the \[tenantId] and \[TriggerId] in the URL with your values.
### The request header
*apikey: 00000000-0000-000-000000000000*
*Content-Type: application/json*
### Payload body in Shopify Flow
The request payload loops through all the tags of a customer in Shopify and checks for a matching tag defined in the payload.
The for-loop code example below checks if a customer has any of the tags: “Male“, “Female“ or “Other“ and sends it through to Engage as "gender":
```liquid theme={null}
{
"gender" : "{%- for tags_item in customer.tags -%}
{%- if tags_item contains "Male" -%}
{{tags_item}}
{%- elsif tags_item contains "Female" -%}
{{tags_item}}
{%- elsif tags_item contains "Other" -%}
{{tags_item}}
{%-endif -%}
{%- endfor -%}"
}
```
The code example above results in a request payload to Engage that looks like this:
```json theme={null}
{
"gender" : "Female"
}
```