Quickstart: Create your first workflow by using Azure Logic Apps - Azure portal

This quickstart introduces the basic general concepts behind how to build your first workflow by using Azure Logic Apps, such as creating a blank logic app, adding a trigger and an action, and then testing your logic app. In this quickstart, you build a logic app that regularly checks a website's RSS feed for new items. If new items exist, the logic app sends an email for each item. When you're done, your logic app looks like this workflow at a high level:

High-level example logic app workflow

For this scenario, you need an email account from a service that's supported by Azure Logic Apps, such as Office 365 Outlook, Outlook.com, or Gmail. For other supported email services, review the connectors list here. In this example, the logic app uses Office 365 Outlook. If you use a different email service, the overall general steps are the same, but your user interface might differ slightly.

Also, if you don't have an Azure subscription, sign up for a free Azure account.

Sign in to the Azure portal

Sign in to the Azure portal with your Azure account credentials.

Create your logic app

  1. From the Azure home page, in the search box, find and select Logic Apps.

    Find and select "Logic Apps"

  2. On the Logic Apps page, select Add.

    Add new logic app

  3. On the Logic App pane, provide details about your logic app as shown below. After you're done, select Create.

    Provide details for new logic app

    Property Value Description
    Name <logic-app-name> Your logic app name, which can contain only letters, numbers, hyphens (-), underscores (_), parentheses ((, )), and periods (.). This example uses "My-First-Logic-App".
    Subscription <Azure-subscription-name> Your Azure subscription name
    Resource group <Azure-resource-group-name> The name for the Azure resource group used to organize related resources. This example uses "My-First-LA-RG".
    Location <Azure-region> The region where to store your logic app information. This example uses "West US".
    Log Analytics Off Keep the Off setting for diagnostic logging.
  4. After Azure deploys your app, on the Azure toolbar, select Notifications > Go to resource for your deployed logic app.

    Go to newly created logic app resource

    Or, you can find and select your logic app by typing the name in the search box.

    The Logic Apps Designer opens and shows a page with an introduction video and commonly used triggers. Under Templates, select Blank Logic App.

    Select blank template for logic app

Next, add a trigger that fires when a new RSS feed item appears. Every logic app must start with a trigger, which fires when a specific event happens or when a specific condition is met. Each time the trigger fires, the Azure Logic Apps engine creates a logic app instance that starts and runs your workflow.

Add the RSS trigger

  1. In the Logic App Designer, under the search box, select All.

  2. In the search box, enter rss to find the RSS connector. From the triggers list, select the When a feed item is published trigger.

    Select "When a feed item is published" trigger

  3. Provide this information for your trigger as shown and described here:

    Set up trigger with RSS feed, frequency, and interval

    Property Value Description
    The RSS feed URL http://feeds.reuters.com/reuters/topNews The link for the RSS feed that you want to monitor
    Interval 1 The number of intervals to wait between checks
    Frequency Minute The unit of time for each interval between checks

    Together, the interval and frequency define the schedule for your logic app's trigger. This logic app checks the feed every minute.

  4. To collapse the trigger details for now, click inside the trigger's title bar.

    Collapse logic app shape to hide details

  5. Save your logic app. On the designer toolbar, select Save.

Your logic app is now live but doesn't do anything other than check the RSS feed. So, add an action that responds when the trigger fires.

Add the "send email" action

Now add an action that sends an email when a new item appears in the RSS feed.

  1. Under the When a feed item is published trigger, select New step.

    Under trigger, select "New step"

  2. Under Choose an action and the search box, select All.

  3. In the search box, enter send an email to find connectors that offer this action. From the actions list, select the "send an email" action for the email service that you want to use. This example uses the Office 365 Outlook connector, which has the Send an email action.

    Select the "Send an email" action for Office 365 Outlook

    To filter the actions list to a specific app or service, you can select that app or service first:

    • For Azure work or school accounts, select Office 365 Outlook.
    • For personal Microsoft accounts, select Outlook.com.
  4. If your selected email connector prompts you to authenticate your identity, complete that step now to create a connection between your logic app and your email service.

    Note

    In this specific example, you manually authenticate your identity. However, connectors that require authentication differ in the authentication types that they support. You also have options to set up the way that you want to handle authentication. For example, when you use Azure Resource Manager templates for deployment, you can parameterize and secure inputs that you want to change often or easily, such as connection information. For more information, see these topics:

  5. In the Send an email action, specify the data that you want the email to include.

    1. In the To box, enter the recipient's email address. For testing purposes, you can use your email address.

      For now, ignore the Add dynamic content list that appears. When you click inside some edit boxes, this list appears and shows any available parameters from the previous step that you can include as inputs in your workflow.

    2. In the Subject box, enter this text with a trailing blank space: New RSS item:

      In the "Subject" property, enter your email subject

    3. From the Add dynamic content list, select Feed title to include the RSS item title.

      From dynamic content list, select "Feed title" property

      When you're done, the email subject looks like this example:

      Finished email subject example for added feed title

      If a "For each" loop appears on the designer, then you selected a token for an array, for example, the categories-Item token. For these kinds of tokens, the designer automatically adds this loop around the action that references that token. That way, your logic app performs the same action on each array item. To remove the loop, select the ellipses (...) on the loop's title bar, then select Delete.

    4. In the Body box, enter this text, and select these tokens for the email body. To add blank lines in an edit box, press Shift + Enter.

      Select properties for email body content

      Property Description
      Feed title The item's title
      Feed published on The item's publishing date and time
      Primary feed link The URL for the item
  6. Save your logic app.

Next, test your logic app.

Run your logic app

To manually start your logic app, on the designer toolbar bar, select Run. Or, wait for your logic app to check the RSS feed based on your specified schedule (every minute). If the RSS feed has new items, your logic app sends an email for each new item. Otherwise, your logic app waits until the next interval before checking again. If you don't get any emails, check your junk email folder.

For example, here is a sample email that this logic app sends.

Sample email sent when new RSS feed item appears

Technically, when the trigger checks the RSS feed and finds new items, the trigger fires, and the Azure Logic Apps engine creates an instance of your logic app workflow that runs the actions in the workflow. If the trigger doesn't find new items, the trigger doesn't fire and "skips" instantiating the workflow.

Congratulations, you've now successfully built and run your first logic app with the Azure portal.

Clean up resources

When you no longer need this sample, delete the resource group that contains your logic app and related resources.

  1. On the main Azure menu, select Resource groups, and then select your logic app's resource group. On the Overview pane, select Delete resource group.

    Find, select, and delete resource group

  2. When the confirmation pane appears, enter the resource group name, and select Delete.

    To confirm deletion, select "Delete"

Note

When you delete a logic app, no new runs are instantiated. All in-progress and pending runs are canceled. If you have thousands of runs, cancellation might take significant time to complete.

Next steps

In this quickstart, you created your first logic app that checks for RSS updates based your specified schedule (every minute), and takes action (sends email) when updates exist. To learn more, continue with this tutorial that creates more advanced schedule-based workflows: