--- title: "Configure Approvals Solution" slug: "configure-approvals-solution" description: "Learn to configure your Approvals solution, manage approvers, and set up workflows for efficient form submissions and notifications." updated: 2026-04-07T15:27:25Z published: 2026-04-07T15:27:25Z canonical: "www.civicplus.help/configure-approvals-solution" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Configure Approvals Solution This article goes over how to adjust the settings for your Approvals solution, add approvers, and manage approval webhooks. The Approvals solution allows you to create approval workflows for your forms. Workflows require form submissions to be reviewed by a specified approver before any [approval events](/process-automation/docs/add-an-approval-event-to-a-form) are triggered. > [!NOTE] > Important Notes > > - An approver must be added to the Approvals solution before they can be used in [approval flows](/process-automation/docs/add-an-approval-flow-to-a-form). > - Users added as approvers will only have access to the Approvals solution. To give them access to other areas of your instance, they will need to be [added as Team Members](/process-automation/docs/add-manage-team-members). ## Configure Your Approvals [Embedded content](https://www.iorad.com/player/1788285/CivicOptimize--How-to-Manage-Approvals-Practice-Tutorial) 1. [Sign in to your site](/process-automation/docs/sign-in-to-your-site) 2. Navigate to the **Approvals** tab![The Approvals option in the navigation menu.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Menu%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=RoT2F1cA9LVdESw9JDMl0f%2BM%2BzXmgXQgbLzhW0BU%2FQY%3D) 3. Configure settings on the **Summary** tab ![Summary page for the Approvals application with customization options and notifications.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Summary%20Fields%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=c7Lj15E2q%2BaSWZJpAYZ0Q98ZguYXVjmEOF5RP1G%2Fptg%3D) - **Details:** The title and tagline of your application that will be displayed when opening your app, as well as the link to open your Approvals Applet - **Email Sending:** This is the email address that will be used to send emails to your approvers - **Advanced Styling:** Customize the CSS code for your app - **Color Theme:** This allows you to customize the Primary and Accent colors for your application - **Notifications:** Enter the email addresses that should be sent notifications if any [webhooks](/process-automation/docs/webhooks) fail - **Logo:** Upload an image to use for the Approvals application > [!WARNING] > **Note**: The image should be 512 px in size. - **Developer Keys:** Assign [Developer Keys](/process-automation/docs/developer-keys) to Approval Groups, giving them the same permissions that an approver would have. 4. Click **Save** to save any changes ![The Save button on the Approvals page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save%20Approvals%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=VduoFRIv5D2jWXqQfWnEvAqMYwdbHMLZJBhX19U4rMo%3D) 5. Navigate to the **Approvers** tab![The image shows a navigation menu with the 'Approvers' tab highlighted.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvers Tab - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=uPHx%2FabfzojQDcmCWCgBpWFSs8pZcnlg3fMBIpD8yM8%3D) 6. Select the **+** icon in the bottom right corner to add approvers ![The Add User button on the users screen.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Add%20User%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=CheLtC5r9r64RMKqarqibO7viHz%2Fsa2RClrFOEkB65g%3D) > [!WARNING] > **Note**: > > An approver must be added to this list before they can be used in your approval flows. 7. Fill out the details for the new app user ![Form for adding a new app user with email and group options.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20New%20User%20Fields%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=mw5yVwcQKkkZ1Bi1QXImSJKY8Sz3AwH8OaJwx1XMWTE%3D) - **Email Address:** Enter the user's email address - **Groups:** Add the user to the applicable approval group(s) that will then be used when [creating approval workflows on a form](/process-automation/docs/add-an-approval-flow-to-a-form). Approval workflows are only set at the group level and will apply to all users within that group. - **Group Manager:** Check if the user should be able to view and edit all approvals for their assigned groups on the [Administration side of Approvals](/process-automation/docs/administration-approvals) - **Administrator:** Check if the user should have full [administrator access to all approvals](/process-automation/docs/administration-approvals) 8. Click **Save![The Save button on the New App User screen.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Save%20User%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=VvZVbUthNDsQwDzJexjA9imm50%2BrQ42ivMmZuIitEkk%3D)** - Once added, your approvers will receive an email invitation with instructions on how to log in or create an account. **![Invitation to join the Approvals app with instructions for account access and password recovery.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Email%20Invite%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=u5PAim4kfAz43fho2w9LDfrT6pRHv654lFYUHnGK5cQ%3D)** 9. To edit an existing approver's groups, select the **pencil icon** next to the user ![The edit user icon next to a user.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Edit%20User%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=FL6VYlBrVnESjiPmlW1moafpC3IYSahn03BYEOz%2BR1k%3D) 1. Adjust the groups as needed and click **Save![Editing app user settings with highlighted group and save button options.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20Edit%20User%20Group%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=vRkydCmuqi7jlwATdE50l%2Fw%2FLjGE9xS6WDOvJmBj%2B1E%3D)** 2. The updated groups will show as tags next to the user ![Highlighted group options for an approval user.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals,%20User%20Groups%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=A0OM1WpjcR0YXHdrP8hNJSU%2BiEtsO59%2BjfVktXkuNaM%3D) > [!WARNING] > **Note**: > > Groups can then be [assigned to Approval Workflows on a form](/process-automation/docs/add-an-approval-flow-to-a-form). 10. Approvers who are part of a group that has been [assigned to a workflow](/process-automation/docs/add-an-approval-flow-to-a-form) will receive an email letting them know when a new approval has been created. From this email, they can access the approval directly or access the list from the [Approvals screen](/process-automation/docs/view-manage-assigned-approvals).![Notification for pending approval of pet license renewal submission with action button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Pending%20Approval%20Email%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=JLFgSgDeUXvcEaRlT4J4exIgUu7COImbUH69lWzxYmg%3D) --- ## (Optional) SAML Integration with Approvals Approvers can also authenticate using a **SAML provider** such as [Entra ID (formerly Active Directory)](/process-automation/docs/microsoft-entra-id-active-directory-integration) and [Auth0](/process-automation/docs/auth0-integration). ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Integrate with a SAML SSO Provider - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=rLEmwuulZhqsLksXv%2B4odjo7cht6wGMOcUpql5o98CM%3D) ### SAML Groups Once SAML is turned on, you will need to configure your Groups. Please note that your existing groups will not carry over as SAML groups so these will need to be reconfigured if you have existing flows that are using the same group name. 1. On the **Approvers** tab, click **Edit Groups** ![](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals Edit Groups - PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=e192rkJNji3R24BX3HSGB0kGMm0o8g9XpuUeRaz%2Btfw%3D) 2. Add your groups and optional notification email addresses ![Add Groups fields.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Approvals%20Add%20Groups%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=Rxw%2BYKtVgFhnggbm7zyZgoUhaEUdC%2ByI08o4KxTNzPQ%3D) - **Group Name:** This is the name of your group, which will be displayed when selecting the group to assign an approval step to. - **Notification Email Addresses:** You must add at least one notification email address, which will be notified when new approvals are assigned to the group. - **Group Manager & Administrator:** When using SAML authentication, you can use the out-of-the-box group manager (oneblink:manager) and administrator claims (oneblink:administrator). Alternatively, you can grant those same permissions to any SAML group by checking the corresponding box. 3. Once your Groups are configured you will need to follow the steps on the screen to configure your [Entra ID (formerly Active Directory)](/process-automation/docs/microsoft-entra-id-active-directory-integration) or [Auth0](/process-automation/docs/auth0-integration) integration. ![SAML Configuration Instructions.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML%20Configuration%20Instructions%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=T0ofthJ%2Bmkwo5Eg%2FZo547M%2F4uVfU1SGMeVhSmvjzaA8%3D) ### SAML Groups Mapping When using SAML to authenticate your approvals users, you will need to ensure that the SAML claims include a "groups" claim. This will need to be a comma-separated string including all of the groups the user has access to. In the example below, using Entra ID, the "groups" claim is mapped to the "user.department" attribute. ![SAML Groups Claim.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML%20Groups%20Claim%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=Bp%2BHv0rQ44vJFyyUPF%2F7ughacaBo7CxmbMJRxCWQpmg%3D) In the "user.deparment attribute" a comma-separated string is included that matches the group names configured within theconsole "support,reviewer,oneblink:adminisrator". The oneblink:administrator group is also included to ensure the user has access to the administrator privilages. ![SAML Department mapped.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML%20Department%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=v4bipsADUh%2FUoWk%2Fl%2FMX%2BfJeQk3Jmwch2IC7TUdqTTE%3D) ![SAML Groups Example.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/SAML%20Groups%20Example%20-%20PADS.png?sv=2026-02-06&spr=https&st=2026-11-22T12%3A59%3A08Z&se=2026-11-22T13%3A59%3A08Z&sr=b&sp=r&sig=F%2BsItDMGGBAddpfWCwWuSb1i6JjEzmi%2Fa1RrvuGJmjA%3D) Cascading Syle Sheet. Pixels Security Assertion Markup Language. ## Related - [View and Manage Assigned Approvals](/view-and-manage-assigned-approvals.md) - [Create an Email Approval Flow Template](/create-an-email-approval-flow-template.md)