Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create Address List activity

The Create Address List activity creates a new address list that acts as an alias for emailing all users in the group.

This alias cannot be used to manage user permissions. This activity implements the Microsoft Exchange New-AddressList command.

To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Exchange > Address List.

Note: This activity replaces an Exchange activity by the same name available in releases prior to Geneva. If you have a workflow created in a previous version that uses the deprecated activity, your workflow will continue to work normally after upgrading to Geneva. However, all new workflows must use the custom version of this activity. This activity was built with the PowerShell activity designer, which gives workflow administrators the ability to store input and output variables in the databus.

Input variables

VariableDescription
hostnameThe hostname of the Exchange server with which the activity interacts. Do not enter an IP address in this variable.
domainThe name of the Exchange server's assigned domain.
nameName of the new address list to create.
parameters

Optional parameters to pass to the Exchange server written in JavaScript Object Notation (JSON). Exchange activities cannot pass parameters that reference an object, such as a PSCredential object. Plain text is automatically converted to SecureString objects for parameters that require that data type.Attempting to save an activity that specifies duplicate parameters, including parameters from activity variables, or incorrectly formatted JSON causes a warning message to appear.

Note: When passing a switch parameter, such as ForceUpgrade, you must use the format "parameter":"true".

Output variables

VariableDescription
resultEither success or failure.
errorError message if the operation fails.
outputRaw XML payload from the Exchange server. This data includes all Exchange attributes.

Conditions

ConditionDescription
SuccessThe activity succeeded in creating a new address list.
FailureThe activity failed to create a new address list.