Create SharePoint Groups With Workflow

Creating a SharePoint group with the /_api/web/sitegroups call is a two step process:

1.  Getting your ContextInfo security token
2.  Make a web request to the sitegroups endpoint to create the group

Part 1: Getting your security token

The first step is making a call to the ContextInfo api with the Web Request action to get your Request Digest security token:

Your web request should have the following configuration:

URL: {Workflow Context:Current site URL}‌/_api/contextinfo
Method: POST
Content type: application/x-www-form-urlencoded
Header name: Accept
Header Value: application/json;odata=verbose

Body: Content
{}
Username: <Username>
Password: <Password>

Store response content in: ContextInfo Response <Text Variable>

You will then want to extract out the actual token value from your call's response. There are a couple different ways that you can do this, but in my example I'm using the 'Extract Substring of String from Index with Length' action with the following configuration:

String: {Variable:ContextInfo Response}‌
Index: 134
Number of Characters: 157
Output: Digest Token <Text Variable>

If you'd like you can then log your 'Digest Token' variable to the history or send it in an email to validate that you're retrieving a valid token.

Part 2: Creating the SharePoint Group

The second part of your workflow will actually create the SharePoint group. We will also do this with the Web Request action, however we will first need to build the appropriate headers, metadata and parameters for this request using the Build Dictionary action.

Build Request Header: 

Key | Type | Value

content-type | Text | application/json;odata=verbose
X-RequestDigest | Text | {Variable:Digest Token}‌
accept | Text | application/json;odata=verbose

Output: Request Headers

Build Metadata:

type | Text | SP.Group

Output: Metadata

Build Parameters: 

Key | Type | Value

__metadata | Dictionary | Variable:Metadata
Title | Text | <Group Name>
Description | <Group Description>

Output: Group Parameters

// You can add additional group parameters if you'd like such as:
AllowMembersEditMembership, AllowRequestToJoinLeave, AutoAcceptRequestToJoinLeave, etc. You can review the MSFT documentation to review all SP group parameters that are available.

Now that we have our security token, headers, metadata, and parameters we can finally use the Web Request action to make our API call and create the SharePoint group:

URL: {Workflow Context:Current site URL}‌/_api/web/sitegroups
Method: POST
Content type: application/json;odata=verbose
Header name: x-RequestDigest
Header value: {Variable:Digest Token}‌
Body (Content): {Variable:Group Parameters}‌
Username: <Username>
Password: <Password>

Store response content in: Request Response Content <Text Variable>
Store http status code in: Response Status Code <Integer Variable>

You can then log the response back to the workflow history, or send yourself an email with the response to ensure that it ran successfully!

Hope this helps, and be sure to check out other workflow templates within the new Process Accelerator Gallery!