--- title: "Create a recipe from scratch" slug: "create-a-new-recipe-from-scratch" updated: 2025-07-29T09:46:29Z published: 2025-07-29T09:46:29Z canonical: "docs.hunters.ai/create-a-new-recipe-from-scratch" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.hunters.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a recipe from scratch ## About recipes Using Hunters Workflows, you can build your own automated processes (Recipes) that will save time and effort managing your day-to-day SOC activities. Recipes are automated workflows built by users that can span multiple apps. Each recipe consists of a **trigger** and one or more **actions** that are executed when a trigger event is detected. When recipes start, they will run automatically in the background to look for trigger events and carry out recipe actions. When they are stopped, they will cease to look for trigger events. 📘 Learn more To learn how to create a workflow from a selection of pre-made templates, click [here](/v1/docs/use-a-pre-made-template). ## Create a recipe 💡Before you start - In this example, we will create a Recipe that creates an issue in Jira for every new Alert in Hunters with a High risk score. - Make sure you have a Hunters API token with a **Customer** role (or higher). Learn more [here](https://docs.hunters.ai/apidocs/manage-api-tokens). - Make sure you have connection credentials to Jira. You can connect with a username and password, API token, OAuth 2.0 or a personal access token. ****Step 1: Open a new Recipe**** 1. From the Hunters menu, navigate to **Workflows > Workflow Manager**. 2. Under **Projects**, navigate to the folder where you want to create the Recipe and click **Create > Recipe**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28119%29.png) > [!NOTE] > 📘Learn more > > [Learn more](/v1/docs/organize-hunters-workflows) about Workflow folders. 3. Give your new Recipe a descriptive name, such as “Create an issue in Jira”. 4. Now, select a starting point for your Recipe from the options below and then click **Start building**: - **Trigger from an app** - select your Recipe trigger from a connected app, such as Hunters, Jira, or other services. - **Run on a schedule** - configure a Recipe that will run on scheduled times. - **Trigger from a webhook** - this option executes Recipe actions when webhooks are received. When a recipe is stopped, it will not process webhooks. For our example, we will select **Trigger from an app**. Your new Recipe design page will now open, with a trigger step ready to set up. ****Step 2: Define a trigger**** 1. From the right-side panel, select the app from which to select your trigger. Each app has a predefined list of triggers you can choose from. For our example, we will select **Hunters > New Alert**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28120%29.png) 2. You’ll now be asked to connect to your account in the selected app. In our example, connect to your Hunters account: - Create a Hunters API token with a **Customer** role (or higher) following [these](https://docs.hunters.ai/apidocs/manage-api-tokens) guidelines. - Copy and paste the **Client ID** and **Client secret** provided in the token creation process. - Select your **Region** based on the region set up for you upon Hunters tenant creation. - Click **Connect**. ****Step 3: Set up the trigger settings**** You can configure your trigger using optional fields and conditions so that the Recipe will run only from a specific date or when certain conditions are met. Every trigger has different setting options. 📘Learn more To view all optional fields, click **Show optional fields**, select all available fields, and then click **Apply** changes. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28121%29.png) Hunters triggers show the following settings: - **Pick up events from** - When starting the recipe for the first time, determine from which date the recipe will pick up records. Leave this field blank to fetch records created an hour ago. Once the recipe has been run or tested, this value cannot be changed. - **Trigger poll interval** - Determine how frequently to check for new events. The default and minimum value is 5 minutes, unless otherwise specified. - **Set trigger conditions** - Use conditions to run the Recipe only when specific conditions are met. Learn more [here](https://docs.workato.com/recipes/triggers.html#trigger-conditions). For our example, we will define a condition that will limit the Recipe to create Jira issues only for Hunters Alerts with a **High** risk score: 1. Activate the **Set trigger conditions** toggle. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28122%29.png) 2. Under the **IF** condition, perform the following: - Click the **Trigger** data field to open a list of data items provided by the New Alert trigger. This list includes information related to the alert, such as its status, assignee, data sources, and more. - From the list, select **Risk**. - In **Condition**, select **equals**, and under **Value** enter **high**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28123%29.png) You can continue to elaborate on this with other IF or AND conditions. ****Step 4: Define an action**** An action defines what will happen once the trigger is activated. 1. To add an action, click the plus sign under **ACTIONS**. ![image.png](https://cdn.document360.io/5f63f0e0-3c70-4d00-b623-82493be0bde5/Images/Documentation/image%28124%29.png) 2. Now, select what happens next from the options below: For our example, we will select **Action in an app** and then, from the right-side panel, **Jira > Create issue**. - **Action in an app** - select an action from a connected app, such as Hunters, Jira, or other services. - [**IF condition / IF/ELSE condition**](https://docs.workato.com/recipes/steps.html#if-condition-step) - define an action based only if certain conditions are met. - [**Repeat action**](https://docs.workato.com/recipes/steps.html#repeat-step) - this option allows you to define an action that will repeat itself in specific conditions (for instance, for a list of items) until stopped. - [**Call function**](https://docs.workato.com/recipes/steps.html#call-recipe-function-step) - this option allows you to trigger another recipe. - [**Stop job**](https://docs.workato.com/recipes/steps.html#stop-step) - ends a single job from being processed any further. It is usually used in cases when there is an error in the business logic and further processing of the job is not required and shouldn’t be used as a first action. - [**Handle errors**](https://docs.workato.com/recipes/steps.html#handle-errors-step) - this option allows you to monitor for errors in actions, similar to the try/catch concept in programming languages. 3. You’ll now be asked to connect to your account in the selected app. In our example, connect to your Jira account. You can connect with a username and password, API token, OAuth 2.0, or a personal access token. 4. You can now customize the action based on the type of action selected. For instance, under Action in an app, you can customize the actions using fields from the app you’ve selected. For our example, use [this](https://docs.workato.com/connectors/jira.html) article to learn about customizing your Jira action to your needs. ****Step 5: Save and start your recipe**** 1. Click **Save,** then **Exit**. 2. Click **Start recipe**.