# Uploadery

### Configuration <a href="#configuring" id="configuring"></a>

#### Uploadery Order Created Trigger <a href="#create" id="create"></a>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FN5S4lPCS2YVNWHzyDKoD%2FDW-uploadery-trigger.png?alt=media&#x26;token=85230b0a-3a60-45f6-beb6-1f91654572b9" alt=""><figcaption></figcaption></figure>

This step is used when you want to collect any files the customer uploads on orders that have upload fields from your Uploadery app.

Optionally, select the **Field Name** of a specific Uploadery field to only filter for that upload field.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Foj5UuErdr9BXjCaxGyls%2FDW-uploadery-field-name.png?alt=media&#x26;token=f9365819-313f-45c2-9861-241350734ea9" alt=""><figcaption></figcaption></figure>

If the field is left empty, it will return all file upload details.

### Potential Use Cases with Uploadery <a href="#potential" id="potential"></a>

**Add a tag to an order based on an Uploadery file**

Follow the steps below to add an order tag based on a file upload added by the customer.

1\. From the **My workflows** page, click on **New Workflow** to start a new workflow.\
\
2\. Select **Uploadery** as the Trigger of the workflow.\
\
In this example, I will be selecting the **Image** Uploadery Field to filter this step to proceed based on the File upload field being used on the order.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FwKvxH4IZrrDAc5lwtt5x%2FDW-uploadery-image.png?alt=media&#x26;token=514f97aa-f126-4fb9-83a3-77641951a8d8" alt=""><figcaption></figcaption></figure>

3\. Select **Shopify** from the apps list and click **Use This** on the **Order Add Tag** action when it populates.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FrH8QuHMcu5U0V0PXVn2y%2FDW-uploadery-order-add-tag.png?alt=media&#x26;token=feeb2514-037e-4ea4-bbb2-35da10d3c4c2" alt=""><figcaption></figcaption></figure>

4\. In the **Shopify Order Update step**, add the **Uploadery Order Created Order ID** to the required **Order ID** field by clicking the [variables](https://docs.getmesa.com/workflow-builder/fields/variables) menu icon {+} and selecting the **ID** variable. This may automatically populate for you.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FwDxuG7800ewRO0yd0oUk%2FDW-uploadery-order-id.png?alt=media&#x26;token=21cf4005-00d0-4359-b168-5cc73e9e281d" alt=""><figcaption></figcaption></figure>

5\. Add the tag you want to apply to the order by entering it in the **Tag** field of the **Shopify Order Add Tag** step.

In this example, I will add the tag **Personalized** to the order.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FftwE3M8uFYeT02Jzs5cs%2FDW-uploadery-tag.png?alt=media&#x26;token=16f90c5c-9ac5-41ef-a21a-4f175e905ad8" alt=""><figcaption></figcaption></figure>

6\. When you’re finished, your workflow should look like this.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fv18i2JJWAJzgSSkaLlZb%2FDW-uploadery-workflow.png?alt=media&#x26;token=a5738562-67aa-485f-8f6d-db75bb5b2bf2" alt=""><figcaption></figcaption></figure>

7\. Turn the workflow on and complete some of the [best practices for MESA](https://docs.getmesa.com/best-practices). You are good to go now! Any orders using the File upload field will now be automatically tagged with a Personalized tag.

5\. At the top of the workflow, hit the **Save** button to save your changes.

6\. Hit the toggle to switch it to **On** when you are ready to start using the workflow.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FxSUQZCm77q5IrNtNuYHq%2FDW-uploadery-enable.png?alt=media&#x26;token=905d1eb3-a2bd-4a71-a98c-f7f293194a47" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getmesa.com/connect/uploadery.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
