Creating a Group
  • 11 Nov 2021
  • 9 Minutes To Read
  • Dark
  • PDF

Creating a Group

  • Dark
  • PDF

Your customers can either be represented by a group or a client. Groups model any customer that is not an individual. Clients model any customer that is just an individual. An example of a group is a small or medium-sized enterprise (SME).

A group is made from a group type. The default group type is Group. You can create as many new group types as you like. You can also create as many groups with the same group type as you like. Examples of group types include joint accounts and institutions.

Clients or individuals are added to a group as members. Members can be assigned group roles names when they are part of a group. Examples of group role names include CEO, secretary, and treasurer.


In Mambu we sometimes refer to group types as group roles. For example in our Configuration as Code (CasC) implementation for client roles and group roles. We also sometimes refer to group role names as group roles. It is important to be aware when the term group role refers to group type or when it refers to group role name, as these are two separate concepts.

Group types

You create a group from a group type. There is a default group type in the system that is called Group. You can edit the default group type. You can also make new group types with different configurations for your organization's needs.

A group's group type can be changed after the group has been created.

You use the Create menu in the top bar in order to create groups from group types. Every group type is listed as an option in the menu.

Please Note
This element can also be configured using Configuration as Code (CasC). For more information, see Configuration as Code.

Create menu with default group type available

Creating group types

In the example below we create a group type called Joint Account.

To create a group type:

  1. On the main menu, go to Administration > General Setup > Client Types.
  2. In the Type dropdown select Group.
  3. In the Add Group Type dialog, enter all the necessary information.
  4. Select Add Group Type.

Add Group Type dialog creating Joint Account group type

Once you have created a new group type it will be available in the Create menu in the top bar. In our example we created a group type called Joint Account and it is available in the Create menu.

Create menu with Joint Account option available

Fields for group types

Name Description Required
Name The name for the group type.
ID The unique identifier for the group type.
Client ID Template The template to generate alphanumeric IDs.
Description The description for the group type.

Client ID Template

Provide a Client ID Template to define the ID number length and format.

Input masks or templates are used to configure Mambu to generate alphanumeric IDs or values of a fixed, specified length, which match the specified pattern of letters and numbers.

Templates consist of the characters `#`, `@`, and `$`, where `#` specifies a number, `@` a letter, and `$` a number or a letter, chosen at random. For example, `@#@#$` will configure Mambu to generate five-character values of one letter, one number, one letter, one number, and one character that is either a letter or a number, such as `B8J4P` or `P1F62`.

Only letters and numbers may be used - special characters and punctuation are not supported. 

Note that the generated values cannot overflow. When all possible values of the specified length run out, no additional values can be generated. For example, the pattern `##` can only produce 100 unique combinations, 0-99. It is important that you specify templates that will provide as many values as you may need into the future.

Allow opening accounts

If you select the Allow opening accounts checkbox then groups made from this group type will be able to open accounts.

In some cases you may want to create a group type that does not allow groups to open accounts. For example, if you create a group for prospective clients that are still going through your Know Your Customer (KYC) checks. You could assign a group type called Prospects to this group. This group type would not be allowed to open accounts. The individuals that are still going through KYC checks would be added to the prospective clients group. Once the clients pass those checks they can be added to a new group with the group type Existing Clients which would have the option to open accounts.

Add Group Type dialog creating Prospects group type

Allow as guarantor

If you select the Allow as guarantor checkbox, then groups made from this group type will be able to be assigned as guarantors.

When a loan is issued, the customer has to provide guarantees. Gurantees can be given in the form of securities such as collateral or someone can be assigned to be a guarantor. This option determines whether a group with this group type can be assigned as the guarantor for a loan.

Show default address fields

If you select the Show default address fields checkbox, then your group creation form will include the default address fields. Otherwise, you can use custom fields to model the address fields section.

Editing a group's group type

To edit the group type of a group:

  1. Go to the group's account by either using the View option in the top menu bar or the Groups menu item on the main menu.
  2. In the top right-hand corner, select Edit.
  3. In the Edit Group dialog, use the Group Type dropdown to select the new group type you would like to assign to the group.

Members and group role names

Members of a group can be assigned a group role name, which is also sometimes called a group role.

One of the most common examples of a group type is an institution or SME group type. In that case, you may want to create group role names for different types of members for the insitution, such as CEO, secretary, managing director, and treasurer.

Another example is if you have a joint account group type, then you may have group role names for a main signatory and a secondary signatory.

Group role names are assigned to members when you are creating or editing a group. We cover assigning group role names to members in the "Assigning group role names" section below.

Please Note
This element can also be configured using Configuration as Code (CasC). For more information, see Configuration as Code.

A list of group role names

Creating group role names

To create a group role name:

  1. On the main menu, go to Administration > General Setup > Group Roles.
  2. Select Add New Group Role Name.
  3. In the Adding Group Role Name dialog, enter the name and ID.
  4. Select Add Group Role Name.
  5. Select Save Changes.

Adding Group Role Name dialog

Assigning a group role name as the recipient of a notification

One of the most helpful uses of group role names is in setting up notifications. When creating emails, SMS, and webhook notifications you can specify who the recipient will be for the notification.

To specify the group role name that will be the recipient for a notification:

  1. On the main menu go to, Administration and then either SMS, Email, or Webhook.
  2. Select Add Notification.
  3. Enter all the necessary information. In the Conditions section, use the Target dropdown to select the Groups option.
  4. The Recipient dropwdown will appear. Use it to select the group role name that will be the recipient for this notification.
  5. Select Save Changes.

Creating a new SMS notification dialog assigning group role name as notification recipient.

For example, if we wanted to send a notification to notify that a repayment is becoming due in a certain number of days then we could set the CFO as the group role name to target to remind them that they have to make this payment. On the other hand, if we create a notification to announce that a loan has been approved then we may set the CEO as the recipient for it.

Creating a group

You create groups from a group type.

The create menu with group types displayed

To create a group:

  1. On the top menu bar, select Create and then select the group type you would like to create a group from.
  2. Enter the information in the Creating a Group dialog. This includes assigning members to the group and assigning the group role names to those members.
  3. Select Create Group.

Creating a Group dialog

Please be Aware

The group ID is generated automatically upon creation of a new group. To modify the group ID when creating or editing a group, you must have the Edit Client ID permission.

Adding group members

To be part of a group, all members need to have a profile created as individual clients.

To add a member to a group:

  1. In the Creating A Group dialog, under Group Members, enter the name of the client you wish to add to the group. As you start typing the client's name, Mambu will automatically provide you with a list of matching names in the system so that you can simply select on the appropriate name in the list.
  2. Select Add Client To Group.

Adding John Smith as a member to a group.

To remove a member from a group:

  1. Hover your mouse over the members name to reveal Delete .
  2. Select Delete .

Deleting a member from a group.png

Adding clients to a group upon client creation

If you have the Manage Client Association permission you can also add clients to a group as members when you create or edit the clients. In the Creating A Client dialog and the Editing Client dialog there is an Association section where you can assign a client as a member to a group.

Association section from Creating A Client or Editing Client dialog, from where the clients can be added in specific groups.

For audit purposes, an activity will be logged when a client has been added to or removed from a group, which is shown in both the client and the group overview.

Assigning group role names to group members

To assign a group role name to a group member:

  1. In the Creating A Group dialog, under Group Roles, select Add Group Role.
  2. A row will appear with a Group Roles dropdown and a Members dropdown. The group roles in the Group Roles dropdown and the members in the Members dropdown are both displayed in alphabetical order. By default the first item in the list for both dropdowns in selected.
  3. Use the Group Roles dropdown and the Members dropdown to select the group role name you want and the member you want to assign it to.

Group Roles. Each group member can have a defined role.

To remove a group role name:

  1. Find the row with the dropdowns specifying the member with the assigned group role name that you would like to delete.
  2. Select Delete next to the row containing the two dropdowns.

Custom fields

If you have set up custom fields for groups then you will have the option to enter information for those as well. For more information, see Setting up Custom Fields.

Assigning groups to branches, centres, and credit officers

If you would like to assign a group to a specific branch, centre and credit officer then you can use the Branch, Centre, and Credit Officer fields in the Association section to do so.

Create Group - Association section with Branch, Centre and Credit Office

Was This Article Helpful?

What's Next