> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/judge.me.md). # Judge.me ## Connection When you're setting up your first workflow with Judge.me, you'll need to create a [Connection](https://docs.getmesa.com/going-further/credentials). Click on **Connect with Judge.me** to start the process.
Screenshot of the Judge.me Connection setup screen in MESA when creating a connection, spotlight the Connect with Judge.me button.
You may be asked to log in to your Judge.me account if not already logged in. Please make sure to [login into your Judge.me account](https://judge.me/login?type=shop) before clicking on **Connect with Judge.me**. Once logged in, your Connection will be selected and MESA is now connected with Judge.me! ## Configure #### Getting a list of reviews by a type After selecting a trigger (which is used to identify when a workflow is triggered), add a Judge.me **Get List of Reviews** step into your workflow. This will tell MESA to get a list of reviews from your Judge.me account. Under **Configure** there is a **More options** button.
Screenshot of the Judge.me Get List of Reviews step Configure section in the MESA workflow builder, spotlight the More options button.
This will allow you to all **Parameters** if applicable.
Screenshot of the Judge.me Get List of Reviews step in the MESA workflow builder with More options expanded, spotlight the Parameters field.
Click on the bulleted points below to learn how you can get reviews by: * [Reviewer](#reviewer) * [Rating](#rating) **Reviewer (Judge.me internal Reviewer)** 1\. To get all reviews created by a specific reviewer, you will want to add a **Judge.me Retrieve Reviewer** step before the **Judge.me Get List of Reviews** step.
Screenshot of the MESA workflow builder showing a Judge.me Retrieve Reviewer step added before the Get List of Reviews step, spotlight the Retrieve Reviewer step.
\ 2\. Once you add that in, click open the **Retrieve Reviewer** step. You will see the ID variable **Configuration** section.
Screenshot of the Judge.me Retrieve Reviewer step opened in the MESA workflow builder showing the Configuration section, spotlight the ID variable field.
Screenshot of the Judge.me Retrieve Reviewer step Configuration section in the MESA workflow builder, spotlight the ID field input.
Screenshot of the Judge.me Retrieve Reviewer step Configuration section in the MESA workflow builder, spotlight the ID variable configuration.
3\. If you don't know the Judge.me internal ID for the reviewer, you can locate the reviewer's information by email address. 4\. To locate the reviewer by email address, you can input " **-1**" into the **ID** field and use [MESA's Variables feature](/workflow-builder/fields/variables.md) to select a Variable that represents the email address. Here is an example of getting the customer's Judge.me reviewer information based on the email address used to place an order.
Screenshot of the Judge.me Retrieve Reviewer step in the MESA workflow builder with -1 entered in the ID field to look up a reviewer by email, spotlight the ID field.
Screenshot of the Judge.me Retrieve Reviewer step in the MESA workflow builder using the Variables feature to select the order email variable, spotlight the Variables selector.
Screenshot of the Judge.me Retrieve Reviewer step in the MESA workflow builder with the customer email variable set for the ID field, spotlight the selected email variable.
\ 5\. Click on the **Get List of Reviews** step and input **reviewer\_id=** into the **Parameters** field. 6\. Use the Variables feature to specify the variable that represents the Reviewer's ID.
Screenshot of the Judge.me Get List of Reviews step in the MESA workflow builder with reviewer_id= entered in the Parameters field, spotlight the Parameters field.
Screenshot of the Judge.me Get List of Reviews step in the MESA workflow builder using the Variables feature to add the Reviewer ID variable to the Parameters field, spotlight the Reviewer ID variable.
Screenshot of the Judge.me Get List of Reviews step in the MESA workflow builder with the reviewer_id parameter mapped to the Reviewer ID variable, spotlight the Parameters field.
7\. You are all set so please make sure to **Save** your changes! **Rating** Click on the **Get List of Reviews** step and input **rating=** into the **Parameters** field. \ Then, enter any of these numbers (1, 2, 3, 4, 5) after the equal sign. They represent a rating number.
Screenshot of the Judge.me Get List of Reviews step in the MESA workflow builder with rating= entered in the Parameters field followed by a rating number, spotlight the Parameters field.
## Technical Notes * In order for the Judge.me webhook triggers to work, you will need to be on a paid plan.