Send email in a workflow (2024)

Open SharePoint Designer 2013 and connect to a SharePoint site

SharePoint Designer 2013 installs as an Office 2013 app. To open SharePoint Designer 2013 and connect to a SharePoint site, follow these steps:

1. To open SharePoint Designer 2013, selectit on theStartmenu. SelectStarticon>All Programs>Microsoft Office 2013>SharePoint Designer 2013.

2. On the SharePoint Designer 2013 start page, selectOpen Site.

3. Enter the SharePoint site that you want to connect to, for example,http://www.contoso.com/sites/a-sharepoint-site.

4. To open the site, selectOpen.

5. If prompted, enter your credentials. (If security is not integrated with the computer you signed in, you are prompted to enter your credentials.) Make sure to use credentials that have access to the SharePoint site.

Create a List workflow based on the SharePoint Workflow platform

1. In the navpane, selectWorkflows node.

2. In theNewsection of the Workflowstab, select theList Workflowdropdown.

3. Select the list that you want to associate with the new workflow.

4. On the Create List Workflow dialog, enter a name and description for the workflow, and then make sure to setthePlatform TypetoSharePoint 2013 Workflow.

5. To create the workflow, select OK.

Now that the workflow is created, you can add Actions, Conditions, Stages, Steps and Loops to build your workflow. These workflow components are available in the SharePoint Designer 2013 ribbon.

Formore infoabout the available list of workflow actions, seeSee Also.

Create the action to send the an email 

1. SelectActions, and then selectSend an Email.

2. In the action, selectthese users.

3. In the Define Email Message dialog, select users from the existing Users and Groups, or enter your own email address in the Tofield.

   Notes:

   • In order to send an email to an external email address. you must be able to retrieve information from the respective email server.

   • The To address of an emailcan either be a specific, static address (for example, NORTHWINDTRADERS\junmin or junmin@northwindtraders.com), or a workflow lookup to variable information. For more info about using workflow lookups to dynamically address emails sent from the workflow instead of using static addresses, seeDynamically select users or groups to receive the message.

   • The sender address of the rendered emailwill always be the email address of the server administrator, unless the server administrator changes the sender address for either the current web appor all web apps. To learn more, read Configure Outgoing Email for a specific web app.

4. In the Subjectfield, entera subject for the email, or to define a workflow lookup to the text you want here, selectDisplay data binding .

   Note:For the workflow to compile correctly, you must make some entry in the Subjectfield.

5. In the large box under the Subjectfield, enteror paste the body text of the email.

   

6. Select OK.

7. Select Action>Go to a stage.

8. Select End of Workflow.

9. SelectPublish.

For more advanced options tomodifythe contents of the email, seethe following sections.

Top of Page

Use a custom list to store recipient addresses

If the recipients change periodically, but not often enough that they must be specified on an initiation form each time that the workflow is started, you can create a custom Recipients list that contains one list item for each workflow that references it, and then create columns in which you can store the addresses to which each emailfrom each workflow is to be sent. When the recipients for any workflow message change, all you have to do is change the addresses in the appropriate field in the Recipients list item for that workflow.

Important:The columns in which you store addresses for workflow emails can be either Single line of text, Multiple lines of text, or Person or Group type columns. If you use a Person or Group column, only one entry can be made in each field that the workflow will reference for email addresses. When creating the column, be sure to select No under Allow multiple selections. If you want to use this type of column to specify multiple recipients, you can create a SharePoint group that includes the people that you want the workflow to address the email to, and then specify the group in the field. When creating the column, be sure to select People and Groups under Allow selection of. Formore infoabout creating lists and adding columns,seeSee Also.

Note:When creating SharePoint groups, make sure that each group has at least Read permissions for the site, and that in the Group Settings area of the New Group page, under Who can view the membership of the group, you selectEveryone.

To use a workflow lookup to a custom Recipients list:

1. In the browser, create a custom list named Recipients with the following three columns:

   • Change the name of the default Title column to Workflow Name. Leave all the other options as is. For more infoabout changing column in a list or library, seeSee Also.

   • Add a Person or Group column named To. In this column, allow selection of both People and Groups, but do not allow multiple selections. Leave all the other options as is. For more infoabout creating column in a list or library, seeSee Also.

   • Add a Single line of text column named Cc. Leave all the other options as is.

2. In the Recipients list, create a new item, and then do the following:

   See Also

   Why am I receiving notifications for lists, forms in lists, or libraries?Set a reminder flow - Microsoft SupportWhat is a Push Notification and Why Do They Matter?Set your SharePoint email notification preferences

   • In the Workflow Name field, enterDocument Reviewwhich is the name of the example workflow used here.

   • In the To field, selectAddress Book and then, in the Select People and Groups dialog, select a single person or group to address emails to.

   • In the Cc field, enterthe email addresses of the recipients to address copies to, separating multiple addresses with semicolons.

3. Create a new workflow.

4. SelectActions, and then selectSend an Email.

5. In the Action, selectthese users.

6. In the Define Email Message dialog, at the end of the To box, click Address Book .

7. In the Select Users dialog, in the Or select from existing Users and Groups list, selectWorkflow Lookup for a User, and then selectAdd.

8. In the Lookup for Person or Group dialog, selectthe following options:

   • Data Source: Recipients, or the name of your custom list.

   • Field from source: To, or the field that holds the address you want in the To line.

   • Return field as: Login Name.This decides the "To" field format in the email.

   • Field: Recipients: Workflow Name

   • Value: EnterDocument Review, or the name of the current workflow.

     

     This lookup states, "From the Recipients list, select the value of the To field where the Workflow Name equals Document Review."

     The top half of the dialogspecifies the list and the column; the bottom half of the dialogspecifies the row.

9. In the Lookup for Person or Group dialog box, selectOK.

10. In the emailabout ensuring unique lookups, selectOK.

11. To close the Select Users dialog, selectOK again.

12. In the Define Email Message dialog, at the end of the CCfield, selectAddress Book .

13. In the Select Users dialog, in the Or select from existing Users and Groups list, selectWorkflow Lookup for a User, and then selectAdd.

14. In the Define Workflow Lookup dialog, selectthe following options:

    • Data Source: Recipients, or the name of your custom list.

    • Field from source: Cc, or the field that holds the address you want in the Cc line.

    • Return field as: Login Name.This decides the "To" field format in the email.

    • Field: Recipients: Workflow Name

    • Value: EnterDocument Review, or the name of the current workflow.

      

      This lookup states, "From the Recipients list, select the value of the Cc field where the Workflow Name equals Document Review."

15. SelectOK, and in the warning message, selectOK again.

16. To close the Select Users dialog, selectOK.

Now, when the workflow sends this email, it sends it to the addresses listed in the To and Cc fields of the Document Review item in the custom Recipients list. To change recipients, simply make the changes you want in the list item.

A single workflow may send multiple emails, and the emails may not all be sent to the same recipients. To store other addresses for additional emails sent by this workflow, you can add columns to the list to store the other addresses. In this case, you may want to name the columns "First message To," "Second message To," and so on.

Alternatively, you can design the list so that you create one item for each emailthat the workflow sends, instead of one item for each workflow. In this case, make sure that the name used to identify each emailis unique, so that the lookups that retrieve the addresses return the unique value that you want.

Use the workflow initiation form to specify recipients

If you want recipients to be specified each time that a workflow is started manually, you can customize the workflow initiation form to collect the addresses from the person who starts the workflow. The workflow can then either simply use the entered addresses directly, or copy them into fields in the current item— where they will still be available for reference after the workflow has completed its current instance. If the workflow is set up so that it also starts automatically, you can specify default addresses in the initiation form for whenever an automatic start occurs.

Top of Page

If the current item is a document in a document library

In the workflow startup notification example, you might want to provide a link to the new document itself:

1. Enter or paste the static text within which you want the link to appear.

2. Select the text, and selectEdit Hyperlink.

3. In the Edit Hyperlink dialog, selectfunction (fx).

   Tip:After you insert a lookup, youcannot drag itto a new location. (It is possible, however, to "relocate" a lookup by dragging other text around it.) Similarly, it is not possible to cut, to copy, or to paste either a lookup or any text that includes a lookup.

4. In the Lookup for String dialog, in the DataSourcefield, select Current Item.

5. In the Field from sourcefield, select Encoded Absolute URL, and then selectOK.

   

When the recipient of the emailselectsthe link, the document opens for viewing or editing.

If the current item is a list item

When you create a link to a list item— for example, an announcement or a calendar event— you can choose to have the link open either the display form (DispForm.aspx), or the edit form (EditForm.aspx) of the list item.

To create a link that opens the list item:

1. In the browser, navigate to the list on which you want to create this workflow.

2. Open the list item for any existing document in the library, using View Item if you want your link to open the display form, or Edit Item if you want your link to open the edit form.

3. Copy the address in the address bar from the beginning http: or https: through the first equal sign (=).

   

4. The ?ID= text is a query string parameter that instructs the page to display the form for whichever item in the current list or library has the list ID that follows the equal sign (=)— which in this example will be the list ID of the current item, as identified by the workflow lookup.

   Note:If the current item is a task that is created by one of the three workflow task actions, and if you want the link to open the custom task form (and not the default display or edit form for the Tasks list), seeIf the current item is a custom task form. For tasks not created by a workflow task action, and for the display forms of even those tasks created by one of the workflow task actions, the current procedure is all that you need.

5. In the Define Email Message dialog, enteror paste the static text within which you want the link to appear, for example - To view the list item, click here.

6. Select the text, and selectEdit Hyperlink.

7. In Edit Hyperlinkbox, for the address field, select String Builder.

8. In the String Builder dialog, paste the address. 

9. Position the insertion point directly after the equal sign (=), and then selectAdd or Change Lookup.

10. In the Lookup for String dialog, in the Sourcefield, select Current Item, and in the Fieldfrom sourcefield, selectID.

    

11. SelectOK.

    The final string in String Builder should start with http:// or https:// and end with [%Current Item:ID%].

    Important:While the current item ID lookup is useful in building links to the current list item, the following lookups can present errors in the rendered path, and wedonot recommendthem for inclusion in emaillinks: Path, Server Relative URL, Source URL, and URL path.

12. Select OK twice.

Your links will appearin blue text with an underline in the email.

If you plan to use the link more than once, continue to the next section.

Store a list item address as a workflow variable

You can store the URL of the display form or edit form of a list item in a workflow variable, so that you can use it in multiple locations in the same workflow.

1. In the Workflow Designer window, selectActions, and then selectExtract Substring from Index of String.

   

2. In the stage, selectstring,and selectellipses button [...].

3. In the String Builder dialog, paste the static text portion of the URL (but not the lookup for the current item ID).

   

4. Position the insertion point after the equal sign (=), and then selectAdd or Change Lookup.

5. In the Lookup for String dialog, in the DataSourcefield, select Current Item, and in the Field from sourcefield, selectID.

   

6. SelectOK.

   The lookup is added to the text in the dialog.

   

7. To close the String Builder dialog, selectOK.

8. Select 0 in Starting at 0 and replace it with 1.

   Note:When Starting at has a value greater than 1, the final string has characters removed.

9. Select Variable: substring or Variable: substring1 in Output to Variable: substring.

10. In the list, selectCreate a new variable and then, in the Edit Variable dialog, entera name for the new variable.

11. Make sure that Type is set to String, and then selectOK.

12. Select below the action you just created and Add the Send an email action to the Actions, and then selectthese users in the action.

13. To use the new variable in the Define Email Message dialog, enteror paste the text within which you want link to appear into the emailbody. Select the text, and from the formatting menu, selectEdit Hyperlink. Select[fx] button, or selectellipses button [...], and then selectAdd or Change Lookup.

14. In the Lookup for String dialog, in the Data Source box list, select Workflow Variables and Parameters.

15. In the Fieldfrom source list, select Variable: name of variable, and then selectOK,and selectOK in the next box.

    

You can now insert this variable anywhere that you want it in the current workflow.

Top of Page

Basic Troubleshooting Tips

The following list of questions may help determine the cause of an issue creating a workflow:

1. Are you able to create any other type of workflow on the same list? For example, try to create an approval workflow.

2. Are you able to create the same workflow:

   • on a different list on the same site?

   • on a different site under same site collection?

   • on a different site collection under same web application?

   • on a different web application?

   • logged in with a different account?

   • using a different computer?

Advanced Troubleshooting Tips

If none of the basic troubleshooting tips help determine the cause of a workflow issue, use these steps:

1. Ensure you have required permissions at site and workflow level. Go to Site Settings>Site Permissions>Check Permissions/List Settings>Permissions for this list, and verify Check Permissions results match the following:

   1. Minimum permissions to design a workflow (save and publish):

      1. on the SharePoint site: Design

      2. on the SharePoint list: Edit

   2. Minimum permissions to start a workflow:

      1. on the SharePoint site: View Only/Read

      2. on the SharePoint list: Contribute

2. Ensure outgoing email settings are set to the correct Exchange server.

   1. Open Command Prompt as an administrator

   2. Run nslookup <Exchange server address>. For example: nslookup exch.contoso.com

   3. You should see the resolved IP address of the Exchange server in the output. If not, contact your Exchange administrator and ask for the correct Exchange fully qualified domain name (FDQN).

3. Send an email to the same person using the SendEmail function of the SPUtility class with SharePoint Management Shell using the following steps.

   1. Open SharePoint Management Shell as an administrator. (Right-click SharePoint Management Shell>Run as administrator)

   2. Run the following script. If the script responds with True, and the user receives an email from SharePoint, SMTP is configured correctly in SharePoint.

   $Site = "Your Site Name"$Email = "User to whom you are sending an email through the workflow"$Subject = "Subject Line with the email"$Body = "Test Email Body"$web = Get-SPWeb $Site[Microsoft.SharePoint.Utilities.SPUtility]::SendEmail($Web ,0,0,$Email,$Subject,$Body)# Below is the same script with sample data $Site = "http://sp/"$Email = "User1@contoso.com"$Subject = "Test Email from SharePoint"$Body = "This is a Test Email"$web = Get-SPWeb $Site[Microsoft.SharePoint.Utilities.SPUtility]::SendEmail($Web ,0,0,$Email,$Subject,$Body)

4. Using SMTP functionality, send an email to the same user from the SharePoint server. Follow the steps in Use Telnet to test SMTP communication.

Note:By default, SharePoint does not create log entries for outgoing mails. SharePoint never sends email directly. The emails are relayed through the SMTP (Exchange) server configured in Central Administration. For troubleshooting this type of workflow, follow the previous steps.