Creating a new Workspace
This page explains how an admin can create a new workspace in the Connect web platform and invite members by assigning them appropriate roles (Admin, Member, or Viewer)
Create a Workspace
Create a workspace to start working on an Opportunity.
Only users (Dimagi) with specific permission can create a workspace. If you need a workspace created and do not have this permission, please reach out to a team member who does.
By adding an workspace, users can accept an invite to join a program.
At the end of this step, a workspace will have a unique identity on the Connect web platform and the user completing this setup will be designated as the “Admin” for this workspace.
The admin setting up the workspace will be able to provide access to other users after the workspace has been set up
This step needs to be executed only one time per workspace. If an workspace has already been created, skip this step and ask the Admin Network Manager to invite user(s) to the workspace. Once an workspace has been set up on Connect, this step does not need to be repeated.
Understanding LLO Entities
An LLO entity represents a unique Local Led Organization. During workspace creation, you must select or create an LLO entity to associate with the workspace. Key points:
One-to-many relationship: A single LLO entity can be associated with multiple workspaces (e.g., the same LLO operating in different countries).
Every workspace should be linked to an LLO entity. This identifies the organization across workspaces.
Selecting the LLO entity at workspace creation (step 3 below) is critical — it links the workspace to the LLO's organizational identity.
After logging in, click on the “Select workspace” dropdown available on top right of the page.
Click on “Create workspace” button.
Select an LLO entity to create a new workspace under, or type a new one if needed. This is the step that links the workspace to the LLO's organizational identity.
Enter the name of your workspace. It is recommended to enter the workspace name and suffix “-country name” to it. For example, if the workspace name is “Sena” and it is based in Nigeria, use “sena-nigeria” as the workspace name.
The workspace name provided now is permanent and cannot be updated in future
Click on Create Workspace button.
An workspace on has been created on the Connect web platform. The user who created the workspace has been designated as the Admin
Once you have successfully created your workspace, notice on the top-right of the Connect homepage -
The name of the workspace you provided is prominently displayed, accompanied by the subtitle "Network Manager."
A circle icon next to it shows your initials. If you click on it, you get to see your username and the role in the workspace (i.e. Admin).
Inviting Members to Join Connect Workspace
Once a workspace is created, workspace Admins can invite team members to collaborate on the Connect web platform.
NOTE: This step can only be executed by the “Admin” of a Connect workspace. A user is assigned an “Admin” role in two scenarios:
If a user created a workspace on Connect
If a user is assigned an “Admin” role while being invited to join a workspace
NOTE: Inviting members can only be done by a workspace Admin. Invited users do not need an existing Connect account before the invitation is sent; they can create one when accepting the invitation.
To send an invitation, execute the following steps:
While logged in, click on the “My Workspace” icon on the left sidebar.
Click on “Members” tab on the new page. Click on “Add Members” button.
Enter your colleague’s email address. They do not need an existing Connect account; they can create one when accepting the invitation. Assign them one of the following roles: Admin, Member, or Viewer. Refer to the Network Manager guide to determine the most suitable role for a co-worker within your workspace.
Click on Submit.
The invited user will receive an invitation email from connect-devops@dimagi.com with an invitation link. The invitation expires after 7 days.
New users: Clicking the invitation link will guide them to sign up for Connect and automatically link them to the workspace after signup is complete.
Existing users: Clicking the invitation link will add the workspace to their account.
Reinviting pending users: Admins can send a new invitation to an email address that already has a pending invite after the cooldown period. A newly sent (or resent) invitation has a 5-minute cooldown, during which it can't be resent again. Reinviting creates a new invitation link, refreshes the expiry window, and makes the older invite link invalid.
The actions the user can perform within the workspace are determined by their assigned role.
Managing Pending Invitations
Admins can view outstanding invitations in the Pending Invites section of the Members tab.
The Pending Invites table shows the invited email address, assigned role, and Expires on date.
If an invitation needs to be sent again, click Reinvite. The button may show Just sent and be temporarily disabled during the 5-minute cooldown period.
If an invitation was sent by mistake or needs to be cancelled, click Revoke next to the recipient’s email address.