Create cross-environment parameters for workflow inputs in Azure Logic Apps

1. In the Azure portal, open your logic app workflow. Under Workflows, select and open your workflow in the designer.

2. From the designer toolbar, select Parameters.

   

3. On the Parameters pane, select Add parameter.

4. Provide the following information about the parameter to create:

   Expand table

   Property	Required	Description
   Name	Yes	The name for the parameter to create.
   Type	Yes	The data type for the parameter, such as Array, Bool, Float, Int, Object, Secure Object, Secure String, and String.
   Default Value	Yes	The default value for the parameter. You have to specify the default parameter value because the workflow logic, connection information, and parameter values don't exist in a single location. The designer must be able to resolve the parameter values before loading. Important: For the Secure Object and Secure String data types, avoid setting a default value because the value is stored as plain text.
   Actual Value	No	The actual value for the parameter.

   The following example shows a definition for a string parameter:

   

5. If you have more parameters to add, select Add Parameter. Otherwise, close the parameters pane, but make sure to save your workflow to save your new parameter definition.

6. To reference the parameter from a trigger or action that's in the same workflow, follow these steps:

   1. In the designer, open the workflow that you want, and expand the trigger or action.

   2. In the property where you want to use the parameter, click inside that property's edit box.

   3. From the dynamic content list that opens, under Parameters, select your previously created parameter, for example:

      

7. To view or edit the parameters in a logic app workflow, follow these steps:

   1. Open the logic app workflow in the designer. On the designer toolbar, select Parameters.

      The Parameters pane opens and displays all the parameters that you defined for that workflow.

   2. Make your edits, close the parameters pane, and save your logic app workflow.

1. In the Azure portal, open your logic app resource. Under Workflows, open your workflow in the designer.

2. From the designer toolbar, select Parameters.

   

3. On the Parameters pane, select Create parameter.

4. Provide the following information about the parameter to create:

   Expand table

   Property	Required	Description
   Name	Yes	The name for the parameter to create.
   Type	Yes	The data type for the parameter, such as Array, Bool, Float, Int, Object, and String. Note: In Standard logic app workflows, secure data types, such as securestring and secureobject, aren't supported.
   Value	Yes	The value for the parameter. In Standard logic app workflows, you have to specify the parameter value because the workflow logic, connection information, and parameter values don't exist in a single location. The designer must be able to resolve the parameter values before loading.

   The following example shows a definition for a string parameter:

   

5. When you're done, close the Parameters pane, but make sure to save your workflow to save your new parameter definition.

6. To reference the parameter from a trigger or action that's in any workflow within the same logic app, follow these steps:

   1. In the designer, open the workflow that you want, and expand the trigger or action.

   2. In the property where you want to use the parameter, click inside that property's edit box.

   3. From the dynamic content list that opens, under Parameters, select your previously created parameter, for example:

      

7. To view or edit parameters in the same logic app, follow either step:

   • Open any workflow in that logic app. On the workflow menu, select Designer. On the designer toolbar, select Parameters.

     The Parameters pane opens and displays all the parameters that you defined from workflows in that logic app.

   • To view or edit in bulk JSON, on your logic app's main menu, select Parameters.

     The Parameters JSON view opens and displays all the parameters that you defined from workflows in that logic app.

1. In a project root-level JSON file named parameters.json, define all the parameters and their values. This file has an object that includes key-value pairs. Each key is the name for each parameter, while each value is the structure for each parameter. Each structure needs to include both a type and value declaration.

   Important

   Your parameters.json file must define and include all the parameters and their values that you reference or use elsewhere in your project, for example, in workflow definitions or connections.

   The following example shows a basic parameters file:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   Note

   In the parameters.json file, @appsetting is the only valid expression type.

2. To reference parameters in your trigger or action inputs, use the expression @parameters('<parameter-name>').

To parameterize your connections.json file, replace the values for literals, such as ConnectionRuntimeUrl, with a single parameters() expression, for example, @parameters('api-runtimeUrl'). In the connections.json file, the only valid expression types are @parameters and @appsetting.

The following example shows a parameterized connections.json file that uses both app settings and parameters. Although you want to use parameters where possible, this scenario is an exception or edge case where you'd use app settings over parameters because app settings are generated during deployment and are easier to dynamically populate in a development pipeline. This sample file uses a parameter for the complex blob_auth authentication object and app settings for the other values. In this case, you can use a parameter for the authentication object as you're unlikely to reference the parameter in your workflow:

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

Typically, you need to manage multiple versions of parameters files. You might have targeted values for different deployment environments, such as development, testing, and production. Managing these parameters files often works like managing ARM template parameters files. When you deploy to a specific environment, you promote the corresponding parameters file, generally through a pipeline for DevOps.

To dynamically replace parameters files using the Azure CLI, run the following command:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

If you have a NuGet-based logic app project, you have to update your project file (<logic-app-name>.csproj) to include the parameters file in the build output, for example:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

For more information about setting up your logic apps for DevOps deployments, review the following documentation:

• DevOps deployment overview for single-tenant based logic apps
• Set up DevOps deployment for single-tenant based logic apps

In single-tenant Azure Logic Apps, app settings contain global configuration options for all the workflows in the same logic app. When you run workflows locally in Visual Studio Code, you can access these app settings as local environment variables in the local.settings.json file. You can then reference these app settings in your parameters.

To add, update, or delete app settings, select and review the following sections for Visual Studio Code, Azure portal, Azure CLI, or ARM (Bicep) template.

To review the app settings for your logic app resource in the Azure portal, follow these steps:

1. In the Azure portal, open your logic app resource.

2. On your logic app menu, under Settings, select Configuration.

3. On the Configuration page, on the Application settings tab, review the app settings for your logic app.

4. To view all values, select Show Values. Or, to view a single value, select that value.

To add a new setting, follow these steps:

1. On the Application settings tab, under Application settings, select New application setting.

2. For Name, enter the key or name for your new setting.

3. For Value, enter the value for your new setting.

4. When you're ready to create your new key-value pair, select OK.

   

5. When you're done, on the Configuration toolbar, select Save.

To review your current app settings using the Azure CLI, run the command, az logicapp config appsettings list. Make sure that your command includes the --name -n and --resource-group -g parameters, for example:

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

To add or update an app setting using the Azure CLI, run the command az logicapp config appsettings set. Make sure that your command includes the --name n and --resource-group -g parameters. For example, the following command creates a setting with a key named CUSTOM_LOGIC_APP_SETTING with a value of 12345:

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

To review and define your app settings in an ARM template or Bicep template, find your logic app's resource definition, and update the appSettings JSON object. For the full resource definition, see the ARM template reference.

This example shows file settings for either ARM templates or Bicep templates:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
],