{"id":110744,"date":"2016-11-02T01:03:48","date_gmt":"2016-11-02T08:03:48","guid":{"rendered":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/"},"modified":"2016-11-02T01:03:48","modified_gmt":"2016-11-02T08:03:48","slug":"call-flow-restapi","status":"publish","type":"power-automate","link":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/","title":{"rendered":"Calling Microsoft Flow from your application"},"content":{"rendered":"<p>Microsoft Flow allows you to turn complex repetitive tasks into automated multistep flows. In many cases, you want your flow to be triggered by an event, such as a document update. In others, you want to let the end user initiate a flow. In this case, Microsoft Flow will serve as an integration glue between your application and large number of other services. For example, you may want the user to click on a button and send an email to her customers. In this article, we will demonstrate five simple steps that will help you build flow and trigger it using simple REST API call. For the sake of simplicity, we are using the <a href=\"https:\/\/www.getpostman.com\">Postman Chrome App<\/a> to send REST API calls.<\/p>\n<h2>Step 1:<\/h2>\n<p>Before we start implementation, let&#8217;s think about the format of the call. In this example, triggering an email from application, we want to pass the following information from the client to the flow: email address, email subject and the text of the email. Our request body will look like this:<br \/>\n\u00a0<\/p>\n<div style=\"background:#eee;border:1px solid #ccc;padding:5px 10px;\">\n{<br \/>\n\u00a0\u00a0\u00a0 &#8220;emailaddress&#8221;:&#8221;&lt;your address goes here&gt;&#8221;,<br \/>\n\u00a0\u00a0\u00a0 &#8220;emailSubject&#8221;: &#8220;Hello&#8221;,<br \/>\n\u00a0\u00a0\u00a0 &#8220;emailBody&#8221;: &#8220;Hello from Microsoft Flow&#8221;<br \/>\n}<\/div>\n<p>\nWe will also need a JSON schema defining the format of the request. To simplify schema creation, you can use one of many schema generators available on the web. We used <a href=\"https:\/\https://www.microsoft.com/jsonschema.net\/\">jsonschema.net<\/a>.<br \/>\n\u00a0<br \/>\nCopy\/paste the request body and click on Generate Schema. The tool will generate a schema like this one:<\/p>\n<pre style=\"background: rgb(238, 238, 238); padding: 5px 10px; border: 1px solid rgb(204, 204, 204); border-image: none;\">\n \n{\n  \"$schema\": \"<a href='http:\/\https://www.microsoft.com/json-schema.org\/draft-04\/schema#\"'>http:\/\https://www.microsoft.com/json-schema.org\/draft-04\/schema#\"<\/a>,\n  \"type\": \"object\",\n  \"properties\": {\n    \"emailadress\": {\n      \"type\": \"string\"\n    },\n    \"emailSubject\": {\n      \"type\": \"string\"\n    },\n    \"emailBody\": {\n      \"type\": \"string\"\n    }\n  },\n  \"required\": [\n    \"emailadress\",\n    \"emailSubject\",\n    \"emailBody\"\n  ]\n}<\/pre>\n<p>\u00a0<\/p>\n<h2>Step 2:<\/h2>\n<p>We start in <a href=\"https:\/\/flow.microsoft.com\/en-us\/\">https:\/\/flow.microsoft.com\/en-us\/<\/a> by creating a new Flow (click on My Flows and Create from blank). When prompted to search for triggers, choose Request.<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.png\" style=\"width: 369px; height: 328px;\"\/><\/p>\n<p>\u00a0<\/p>\n<p>There are two boxes in this form: one for the URL that your application will call, and one for the JSON Schema defining format of the request. Start with the JSON Schema field, and paste the schema generated in Step 1 into it.<\/p>\n<p>\u00a0<\/p>\n<h2>Step3:<\/h2>\n<p>Add an action by clicking on the &#8220;+ New Step&#8221; and choosing &#8220;Office 365 &#8211; send an email.&#8221;<br \/>\nWhen you click on any field in the form, you can see JSON parameters (from the schema) that can be added into the fields.<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure2.png\" style=\"width: 423px; height: 263px;\"\/><\/p>\n<p>\nClick again on the &#8220;+New step&#8221; and choose the &#8220;Response&#8221; action. Here you have an option to either specify the JSON body of the response, such as {&#8220;status&#8221;:&#8221;success&#8221;}, or use the Body of the original request by clicking on the &#8220;Body&#8221; property.<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure3.png\" style=\"width: 433px; height: 225px;\"\/><\/p>\n<p>\u00a0<\/p>\n<p>Please note that if one of the previous steps of the flow fails, this action won&#8217;t execute and your application will receive an error response:<\/p>\n<pre style=\"background: rgb(238, 238, 238); padding: 5px 10px; border: 1px solid rgb(204, 204, 204); border-image: none;\">\n{\n  \"error\": {\n    \"code\": \"NoResponse\",\n    \"message\": \"The server did not receive a response from an upstream server. Request tracking id '08587237214980038925577763844'.\"\n  }\n}\n<\/pre>\n<h2>Step 4:<\/h2>\n<p>Give your flow a name and click on the &#8220;Create Flow&#8221; button. Once your flow is created you can click on the Request bar and see that a URL has been generated by the system:<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure4.png\" style=\"width: 475px; height: 342px;\"\/><\/p>\n<p>\u00a0<\/p>\n<p>Please note that generated URL contains an access key. We recommend that you avoid sharing your URL with anyone else.<br \/>\n\u00a0<\/p>\n<h2>Step 5:<\/h2>\n<p>\n\u00a0<br \/>\nCopy this URL and JSON body into Postman:<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure5_3.png\" style=\"width: 1041px; height: 257px;\"\/><\/p>\n<p>\u00a0<\/p>\n<p>Don&#8217;t forget to add a Content-type header = application\https://www.microsoft.com/json.<\/p>\n<p>Send the request, wait a moment, and then check your inbox for the email. Voila!<\/p>\n<p>\u00a0<\/p>\n<p style=\"text-align: center;\"><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure6.png\" style=\"width: 375px; height: 378px;\"\/><\/p>\n<p>\u00a0<\/p>\n<p>In Postman, you will also see a response:<\/p>\n<pre style=\"background: rgb(238, 238, 238); padding: 5px 10px; border: 1px solid rgb(204, 204, 204); border-image: none;\">\n\n{\n    \"emailadress\":\"myemail@miosoft.com\",\n    \"emailSubject\": \"Hello\",\n    \"emailBody\": \"Hello from Microsoft Flow\"\n}<\/pre>\n<p>Postman can also generate a code snippet for you in programming language of your choice. Click on the Code button and choose programming language.<\/p>\n<p><img decoding=\"async\" alt=\"\" src=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure7.png\"\/><\/p>\n<p>\u00a0<\/p>\n<h2><strong>To summarize<\/strong>:<\/h2>\n<p>Decide on the call format, create a flow with an HTTP Trigger, add an email action and Response Action, and issue a Post request.<br \/>\nNow you can use Flow to create powerful custom HTTP triggers that your application can invoke at any time. Please try it out and share with us your integration\u00a0stories.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>This tutorial will teach you how to trigger Microsoft Flow from an application.<\/p>\n","protected":false},"author":367,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","power-automate-category":[2546,2836],"power-automate-tag":[2623,2763],"coauthors":[2926],"class_list":["post-110744","power-automate","type-power-automate","status-publish","hentry","power-automate-category-developers","power-automate-category-walkthroughs","power-automate-tag-httptrigger","power-automate-tag-rest-api"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Calling Microsoft Flow from your application - Microsoft Power Platform Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Calling Microsoft Flow from your application - Microsoft Power Platform Blog\" \/>\n<meta property=\"og:description\" content=\"This tutorial will teach you how to trigger Microsoft Flow from an application.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/\" \/>\n<meta property=\"og:site_name\" content=\"Microsoft Power Platform Blog\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 min read\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"Irina Gorbach\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/\",\"name\":\"Calling Microsoft Flow from your application - Microsoft Power Platform Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.png\",\"datePublished\":\"2016-11-02T08:03:48+00:00\",\"dateModified\":\"2016-11-02T08:03:48+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.webp\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.webp\",\"width\":369,\"height\":328,\"caption\":\"graphical user interface, text, application\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Power Automate\",\"item\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Calling Microsoft Flow from your application\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\",\"name\":\"Microsoft Power Platform Blog\",\"description\":\"Innovate with Business Apps\",\"publisher\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization\",\"name\":\"Microsoft Power Platform Blog\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png\",\"contentUrl\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png\",\"width\":194,\"height\":145,\"caption\":\"Microsoft Power Platform Blog\"},\"image\":{\"@id\":\"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Calling Microsoft Flow from your application - Microsoft Power Platform Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/","og_locale":"en_US","og_type":"article","og_title":"Calling Microsoft Flow from your application - Microsoft Power Platform Blog","og_description":"This tutorial will teach you how to trigger Microsoft Flow from an application.","og_url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/","og_site_name":"Microsoft Power Platform Blog","og_image":[{"url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 min read","Written by":"Irina Gorbach"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/","name":"Calling Microsoft Flow from your application - Microsoft Power Platform Blog","isPartOf":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage"},"thumbnailUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.png","datePublished":"2016-11-02T08:03:48+00:00","dateModified":"2016-11-02T08:03:48+00:00","breadcrumb":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#primaryimage","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.webp","contentUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2024\/06\/Figure1.webp","width":369,"height":328,"caption":"graphical user interface, text, application"},{"@type":"BreadcrumbList","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/call-flow-restapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/"},{"@type":"ListItem","position":2,"name":"Power Automate","item":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/power-automate\/"},{"@type":"ListItem","position":3,"name":"Calling Microsoft Flow from your application"}]},{"@type":"WebSite","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#website","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/","name":"Microsoft Power Platform Blog","description":"Innovate with Business Apps","publisher":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#organization","name":"Microsoft Power Platform Blog","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png","contentUrl":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-content\/uploads\/2020\/03\/Microsoft-Logo-e1685482038800.png","width":194,"height":145,"caption":"Microsoft Power Platform Blog"},"image":{"@id":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/#\/schema\/logo\/image\/"}}]}},"distributor_meta":false,"distributor_terms":false,"distributor_media":false,"distributor_original_site_name":"Microsoft Power Platform Blog","distributor_original_site_url":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog","push-errors":false,"_links":{"self":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-automate\/110744"}],"collection":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-automate"}],"about":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/types\/power-automate"}],"author":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/users\/367"}],"replies":[{"embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/comments?post=110744"}],"version-history":[{"count":0,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-automate\/110744\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/media?parent=110744"}],"wp:term":[{"taxonomy":"power-automate-category","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-automate-category?post=110744"},{"taxonomy":"power-automate-tag","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/power-automate-tag?post=110744"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.microsoft.com\/en-us\/power-platform\/blog\/wp-json\/wp\/v2\/coauthors?post=110744"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}