Shopify

learn how to connect engini to shopify getting started with shopify prerequisites a shopify account if you don’t have an account, create an account at www shopify com/signup connecting engini to shopify retrieve your shopify access token log in to your shopify admin dashboard and navigate to the “apps” section click on the “app and sales channel setting” button click on the “develop apps” button click on the “create a new private app” button enter a name for your private app and provide an email address for notifications, then click on “create app” button click configuration click on configure button next to admin api integration under the “admin api” section, select the permissions that you want to grant to your app and event version, for now choose 2025 01 click on the “save” button to create the private app switch to the api credentials tab and under access tokens, click install app in the dialog that appears, confirm the action by clicking install shopify creates an admin api access token click reveal token and copy the token add a connection to shopify in engini to connect your shopify account to engini, follow the next steps enter your engini account at https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the "new integration" option located at the topbar choose shopify option from the available applications enter the following details in the “edit connection” form connection name – enter a descriptive and unique name for this connection shopify site url – enter your shopify store’s url here api access token – enter the access token you obtained from shopify general information this section contains essential configurations for your shopify integration please ensure your connection settings are optimized to avoid data mismatches working with shopify metafields to successfully sync metafields with shopify, you must follow a strict structural workflow any deviation from this flow may result in failed api requests or metafields not being saved correct implementation flow initialize the metafields array create a variable and set its object element type to metafields this variable will hold all metafield objects append metafield objects use the append action to add metafields one by one each metafield object must include namespace key type value validate data types and formatting ensure that each metafield’s type and value strictly match shopify’s expected schema for example, list type metafields must be properly serialized (e g , arrays converted using tojsonstring) important shopify enforces strict validation on metafield structure and data types any mismatch will cause the request to fail silently or the data to be ignored if you encounter issues with specific metafield types or formatting, refer to the official shopify metafields api documentation shopify subscription plan field availability depends on your shopify subscription plan in basic plans, shopify restricts access to specific business data attempting to fetch restricted fields will result in errors or empty data common restricted fields in basic plans payment terms (id/name) typically available only for advanced/plus or b2b transactions staff member details of the staff member who processed the order required action within the output fields settings, ensure you uncheck or remove any fields not supported by your shopify plan (such as payment terms or staff member ) to prevent errors, select only standard fields like customer , total price , and line items triggers the trigger is executed automatically in response to a specific event every workflow has to start with a trigger you can use order, customer, refund and product triggers orders order created an order is created when a customer completes the checkout process, during which time they provide an email address, billing address and payment information listens for a new order creation add conditions if you want the trigger “order created” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select the field from the dropdown on which you want to add the condition select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate order updated listens for updates to an order based on specified conditions add conditions if you want the trigger “order updated” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate order fulfilled listens for the fulfillment of an order based on your conditions in shopify, “order fulfilled” means that the order has been processed, and the items purchased by the customer have been shipped or are on their way to the customer add conditions if you want the trigger “order fulfilled” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate order paid listens for the order being paid, based on your conditions add conditions if you want the trigger “order paid” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate order cancelled listens for the order being cancelled, based on your conditions add conditions if you want the trigger “order cancelled” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate customers customer created listens for a new customer creation, based on your conditions add conditions if you want the trigger “customer created” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate customer updated listens for customer’s updates, based on your conditions add conditions if you want the trigger “customer updated” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate refund refund created listens for refund creation, based on your conditions in shopify, “refund created” means that the seller has initiated the process of refunding the customer for a returned or cancelled order add conditions if you want the trigger “refund created” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate products product created listens for a product creation, based on your conditions listens for a product creation add conditions if you want the trigger “product created” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate product updated listens for a product’s updates add conditions if you want the trigger “product updated” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 4 for all the fields you want to populate actions tags add tags now you can add tags to different objects tags the list of tags you want to assign to the object the format should be comma separated, like in the example click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) id the unique identifier of the object you want to tag it must be in shopify gid format, and can be used with customers, orders, draft orders and products click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) products get product get one product to use the “get product” activity in engini you need to fill the id field product id click on the empty field and select the item id that is relevant you can use static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which product properties are returned in the response the dropdown lists all available properties (for example, product title, description, variants, and images) selecting fields adds them to the response schema, while choosing all fields returns the full product object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can choose the value of the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above get products output fields define which products properties are returned in the response the dropdown lists all available properties (for example, products title, descriptions and product id) selecting fields adds them to the response schema, while choosing all fields returns the full products object if no fields are selected, all properties are automatically included by default add filters allows you to refine the list of products that will be returned each filter is defined by selecting a field (such as products id, barcode or price), choosing a condition (for example equals , greater than , less than , or contains ), and then specifying a value by applying filters, you can narrow the query results to only the products that meet the given criteria, instead of retrieving all products click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above create product creates a new product to use the “create product” activity block in engini you need to fill to following fields title the title is the name of the new product you create the title can come from the trigger or another action you performed in the process before the “create product” action click on the empty field and select the title of the new item you create you can use static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the record you are creating you can add one field to the activity or more fields to the activity definitions, up to the number of fields in the board choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields media \[], metafields \[], product options \[] each one of them is an array of objects the array is initialized using intialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required update product product id click on the empty field select the item id that is relevant (note that you choose an id and not a name) you can use static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the record you are updating you can add one field to the activity or more fields to the activity definitions, up to the number of fields in the board choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields media \[], metafields \[] each one of them is an array of objects the array is initialized using intialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required object array initializes object array this activity initializes an object array in shopify and stores a single structured entry based on the selected object type (e g fulfillment order line items ,line items) variable name enter the name of the variable that will hold the initialized object array this name will be used throughout the workflow whenever you refer to this object array object element type this field defines the type of data the array will store, such as fulfillment order line items ,line items the selected type determines the structure of the array and its use in subsequent actions append to object array append to object array is used to add new elements into an array of objects this action is directly connected to initialize object array variable dropdown that lists all object arrays initialized in previous steps of the workflow here you select the specific array to which a new object will be appended add field shows all fields defined under object element type during the initialize step selecting fields here allows you to provide values for each property of the object schema map array the map array activity allows you to transform an object that contains multiple pieces of data into a new data list based on the fileds and values you choose object name select the object you want to map the available options are the same objects that were previously initialized using initialize object array data list the data provided here must match the structure of the selected object name once the object is chosen, you will be able to add fields that correspond to the fields defined in that object add field you can add one field to the activity or more fields to the activity, up to the number of fields you have in the selected object choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate inventory get inventory item get one inventory item to use the “get inventory item” activity in engini you need to fill the id field inventory item id click on the empty field select the item id that is relevant you can use static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which inventory item properties are returned in the response the dropdown lists all available properties (for example, inventory item id, description, quantities, and images) selecting fields adds them to the response schema, while choosing all fields returns the full inventory item object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to include more parameters, repeat the steps above update inventory item inventory item id the id of the inventory item you want to update click on the empty field select the item id that is relevant you can use static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the inventory item you are updating his variants you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate update inventory level in shopify, the inventory level represents the actual quantity of an item available at a specific location ignore compare quantity a boolean indicating whether shopify should skip the comparison against the current stock quantity if false, the update will proceed regardless of mismatched values quantities \[] this expects an array of objects to build it, you must first initialize an object array and then append elements using append to object array each object in this array represents one inventory update each element you append to the quantities array includes the following fields inventory item id – the unique identifier of the inventory item you want to update compare quantity – the current stock level you expect to see in shopify before the update used for concurrency control location id – the id of the location (warehouse or store) where this inventory change applies quantity – the new stock level you want to set for the item at the given location the name of quantities the label or identifier for the quantities array, used internally in the workflow to reference this object can be “available” or “on hand” the reason for the quantity changes an enum field to specify why the inventory level was modified (for example “restock”, “other”, or “correction” and some more) order get order order id click on the empty field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which inventory item properties are returned in the response the dropdown lists all available properties (for example, inventory item id, description, quantities, and images) selecting fields adds them to the response schema, while choosing all fields returns the full inventory item object if no fields are selected, all properties are automatically included by default to more information about shopify subscription plan for this action , discounted plan subscribers cannot select the fields payment terms – id staff member – email staff member – id staff member – name staff member – phone add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action create order tax lines \[] an array of tax details applied to the order each tax line can include information such as the tax rate, title (e g , “vat”), and the amount charged transactions \[] a list of payment transactions related to the order each transaction can include details such as the payment method, amount, and status this is required when recording how the order was paid (e g , credit card, paypal, shop money) add field by clicking the “add field” button, you can choose how to fill in the various fields in the order you are creating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields custom attributes \[], line items \[], metafields \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required update order order id the id of the order you want to update click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the order you are updating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields custom attributes \[], metafields \[], localized fields \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required variant get variant specific version of a product that has a unique combination of attributes such as size, color, material, and price variant id click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which variant properties are returned in the response the dropdown lists all available properties (for example, variant title, description and images) selecting fields adds them to the response schema, while choosing all fields returns the full variant object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above create variant product id the id of the product for which you want to create a variant click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (sing the tooltip that opens when clicking on the field) variants \[] is an array of objects each object represents a single variant of the product to create a variant, you must provide the required fields inside the object the array is initialized using initialize object array, and each variant object is added to it with append to object array without filling in the object, the variant cannot be created you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the variant you are creating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array field media \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required update variant product id the id of the product whose variants you wish to update click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the product you are updating his variants you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields media \[], variants \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required transactions in shopify, a transaction refers to any payment or refund that is associated with an order get transactions output fields define which transactions properties are returned in the response the dropdown lists all available properties (for example, order id, description and transaction id) selecting fields adds them to the response schema, while choosing all fields returns the full transaction object if no fields are selected, all properties are automatically included by default add filters each filter is defined by selecting a field (such as id, processed at or point of sale device id), choosing a condition (for example equals , greater than , less than , or contains ), and then specifying a value by applying filters, you can narrow the query results to only the transactions that meet the given criteria, instead of retrieving all transactions click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above location in shopify, a location refers to a physical address or place associated with the management of inventory and fulfillment get location location id click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which location properties are returned in the response the dropdown all available properties (for example, location title, description and images) selecting fields adds them to the response schema, while choosing all fields returns the full location object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above get locations output fields define which locations properties are returned in the response the dropdown lists all available properties (for example, location title, description and location id) selecting fields adds them to the response schema, while choosing all fields returns the full location object if no fields are selected, all properties are automatically included by default add filters allows you to refine the list of locations that will be returned each filter is defined by selecting a field (such as location id, zip or country), choosing a condition (for example equals , greater than , less than , or contains ), and then specifying a value by applying filters, you can narrow the query results to only the locations that meet the given criteria, instead of retrieving all locations click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above price lists a price list in shopify is a collection of product prices that can be applied to specific customers or markets, allowing the system to display and use those defined prices instead of the default ones get price lists output fields define which price lists properties are returned in the response the dropdown lists all available properties (for example, title, description and price list id) selecting fields adds them to the response schema, while choosing all fields returns the full price list object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above create price list currency defines the currency in which the price list will be created by default, in our setup this will be set to ils parent – adjustment – type specifies the type of price adjustment that will be applied relative to the parent price list for example, whether the adjustment is a percentage increase or decrease parent – adjustment – value defines the numeric value of the adjustment depending on the type selected above, this can represent either the percentage to increase/decrease or the fixed amount to add/subtract from the parent price add field by clicking the “add field” button, you can choose how to fill in the various fields in the price list you are creating you can add one field to the activity or more fields to the activity definitions update price list price list id the id of the price list you want to update his price list click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the price list you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate customers a customer in shopify is a record that stores basic information about a person or company that has interacted with the store, such as their name, contact details, and order history get customers output fields define which customers properties are returned in the response the dropdown lists all available properties (for example, name, address details and customer id) selecting fields adds them to the response schema, while choosing all fields returns the full customers object if no fields are selected, all properties are automatically included by default add filters each filter is defined by selecting a field (such as customer id, email or first name), choosing a condition (for example equals , greater than , less than , or contains ), and then specifying a value by applying filters, you can narrow the query results to only the customers that meet the given criteria, instead of retrieving all customers click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above create customer add field by clicking the “add field” button, you can choose how to fill in the various fields in the customer you are creating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using functions and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields addresses \[], metafields \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required update customer customer id the id of the customer you want to update click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the customer you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields addresses \[], metafields \[] each one of them is an array of objects the array is initialized using initialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required draft order a draft order in shopify is a preliminary order created by the store owner or staff, which can be saved, updated, and later converted into a completed order complete draft order in shopify, complete draft order means finalizing a draft order so that it becomes a regular order in the store once completed, the draft order is no longer editable as a draft, it moves into the standard orders list, payment can be recorded, and the order is treated like any other confirmed purchase draft order id the id of the draft order you want to make a real order click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the draft order you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate receive a single draft order draft order id field click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which draft order properties are returned in the response the dropdown lists all available properties (for example, draft order id, tags, quantities, and updated at) selecting fields adds them to the response schema, while choosing all fields returns the full draft order object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above retrieves a list of a draft orders output fields define which draft orders properties are returned in the response the dropdown lists all available properties (for example, status, tags and draft order id) selecting fields adds them to the response schema, while choosing all fields returns the full draft orders object if no fields are selected, all properties are automatically included by default add filters allows you to refine the list of draft orders that will be returned each filter is defined by selecting a field (such as location id, zip or country), choosing a condition (for example equals , greater than , less than , or contains ), and then specifying a value by applying filters, you can narrow the query results to only the draft orders that meet the given criteria, instead of retrieving all locations click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add parameters by clicking the “add parameter” button, you can define parameters or sort keys for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above modify an existing draft order draft order id the id of the draft order you want to update click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) add field by clicking the “add field” button, you can choose how to fill in the various fields in the draft order you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields custom attributes \[], line items \[], localized fields \[], metafields \[], payment schedules \[] each one of them is an array of objects the array is initialized using intialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required create draft order to create a draft order you must add fields, it cannot be created completely empty however, there are no mandatory fields, so you can choose which details to include add field by clicking the “add field” button, you can choose how to fill in the various fields in the draft order you are creating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array fields custom attributes \[], discount codes \[], line items \[], localized fields \[], metafields \[], payment schedules \[] each one of them is an array of objects the array is initialized using intialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required remove an existing draftorder draft order id click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) fulfillments retrieve specific fulfillment order fulfillment order id click on the field to show the tooltip with all the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which fulfillment order properties are returned in the response the dropdown lists all available properties (for example, fulfillment order id, tax info and total weight) selecting fields adds them to the response schema, while choosing all fields returns the full fulfillment order object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above retrieves a list of fulfillment order for a specific order order id click on the field and choose how to populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) output fields define which order properties are returned in the response the dropdown lists all available properties (for example, order id, channel id, and status) selecting fields adds them to the response schema, while choosing all fields returns the full order object if no fields are selected, all properties are automatically included by default add parameters by clicking the “add parameter” button, you can define parameters for your shopify action you can add one parameter or multiple parameters, up to the maximum number of existing parameters in the action the available parameters vary depending on the specific shopify action choose from the drop down the parameter you want to define click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to define the parameter you can populate the parameter using one of the following options static value a number or string for strings, you need to surround them with single quotes (”) property value from a previous activity select a value from a previous activity using the tooltip that opens when you click on the field expression use https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p , properties from previous activities, and/or static values to add more parameters, repeat the steps above create a fulfillment add field by clicking the “add field” button, you can choose how to fill in the various fields in the fulfillment you are creating you can add one field to the activity or more fields to the activity definitions choose from the drop down the field you want to fill click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields you want to populate object array field fulfillment order \[] each one of them is an array of objects the array is initialized using intialize object array, and each object is added to it with append to object array in case of a single object, the append to object array is not required