Create your first recipe

Build your first recipe with this video guide

A recipe is an automated workflow that connects your apps. Each recipe is comprised of a trigger and one or more actions. When you turn on your recipe, it waits for a triggering event to run the actions.

The following steps guide you through building a recipe that closes a case in Salesforce when an issue with the same name in Jira closes.

Before you start

• To connect to your Jira account, you need the Host name, Email, and API token
  For information on how to generate the API token, see create API token in Atlassian
• To connect to your Salesforce account, you need your username and password.

Step 1: Open a new recipe

1. Navigate to Assets and click Create Recipe.
2. Enter My first recipe in the Name field.
3. Click Start building.

Step 2: Connect to Jira

1. Search for the Jira app.
2. Select Updated issue.
   The Connection page opens.
3. Enter a name for the connection in the Connection name field.
   Since you can reuse connections between recipes, enter a descriptive name so you can identify the account. For example Test Jira account.
4. Enter the URL of your Jira account.
5. Select Yes to use an API token to authenticate.
6. Enter the email you use to login to Jira.
7. Enter the API token you retrieved from Atlassian.
8. Click Connect.
   You can now configure the trigger fields.

Step 3: Set up the trigger

The recipe will run whenever an issue is closed. When you start the recipe, it will check for matching events from the previous seven days.

1. In the When first started... field, enter this formula: 7.days.ago
2. Click to set a trigger condition.
3. In the Recipe data window, search for Status > Name.
4. Drag the Name datapill into the Trigger data field.
5. Set the condition to contains.
6. Set the value to Closed.

Step 4: Connect to Salesforce

1. Click the + below Actions and click Action in app.
2. Search for the Salesforce app.
3. Select Search records.
   The Connection page opens.
4. Enter a descriptive name for the connection in the Connection name field.
5. Click Connect.
   The Salesforce login page opens in a new window.
6. Enter your username and password and click Log In.
   You can now configure the action fields.

Step 5: Set up the action

The recipe will search for cases in Salesforce with the same case name as the Jira issue.

1. In the Search for field, select Case.
2. Enter a limit of 150 records.
3. Drag the Summary datapill into the Subject field.

Step 6: Set up the conditional statement

This step instructs the recipe to check if the Salesforce case is closed. If not, the recipe updates the status to closed.

1. Click the + below Actions and click IF condition.
2. Drag the Status datapill into Data field.
3. Select the equals condition.
4. Enter Closed in the Value field.
5. Click to Select an app...
6. Select the Salesforce app > Update record.
   The action automatically selects the connection you established in Step 4.
7. Select Case.
8. Drag the Case ID datapill into the Case ID field.
9. Select the Closed status.

Step 7: Save and start your recipe

1. Click Save then Exit.
2. Click Start recipe. Your finished recipe should match this recipe (opens new window)

What is next

A few ideas for what you can do next:

• Explore the Community library (opens new window) to find ready-to-use recipes that other users built.
• Learn more about other types of triggers and actions in recipe components