Instantly

Organize multiple workspaces under one Admin workspace

A workspace group allows you to organize multiple workspaces (sub-workspaces) within a single admin workspace. This guide provides step-by-step instructions on managing sub-workspaces through the Instantly platform and via API. ​

​The current release only allows you to manage the workspace grouping through the dashboard. It does not allow you to see data from across different workspaces in one place.

Navigate to Settings &gt; <a href="https://app.instantly.ai/app/settings/account" rel="nofollow noopener noreferrer" target="_blank">Account</a>.

Click the Add sub workspace button.

Click Add sub workspace to send an invitation. The workspace becomes a sub-workspace once the invitation is accepted.

1. Navigate to Settings &gt; <a href="https://app.instantly.ai/app/settings/account" rel="nofollow noopener noreferrer" target="_blank">Account</a>.
2. Go to the Workspace Group tab.
3. Click the Add sub workspace button.
4. Enter the workspace ID.
5. Click Add sub workspace to send an invitation. The workspace becomes a sub-workspace once the invitation is accepted.

Use the POST <code>/workspace-group-members</code> endpoint.

Set the <code>sub_workspace_id</code> field to the workspace you want to invite.

Send the request. The workspace becomes a sub-workspace once the invitation is accepted.

1. Use the POST <code>/workspace-group-members</code> endpoint.
2. Set the <code>sub_workspace_id</code> field to the workspace you want to invite.
3. Send the request. The workspace becomes a sub-workspace once the invitation is accepted.

___________________________________________________________

Locate the sub-workspace in the Sub workspaces section.

Click the Remove button. The workspace is removed immediately.

1. Navigate to Settings &gt; <a href="https://app.instantly.ai/app/settings/account" rel="nofollow noopener noreferrer" target="_blank">Account</a>.
2. Go to the Workspace Group tab.
3. Locate the sub-workspace in the Sub workspaces section.
4. Click the Remove button. The workspace is removed immediately.

Use the GET <code>/workspace-group-members</code> endpoint to get a list of sub-workspaces.

Identify the sub-workspace to remove using the <code>sub_workspace_id</code>.

Send a DELETE request to the <code>/workspace-group-members/:id</code> endpoint, replacing <code>:id</code> with the appropriate ID.

The sub-workspace is removed immediately.

1. Use the GET <code>/workspace-group-members</code> endpoint to get a list of sub-workspaces.
2. Identify the sub-workspace to remove using the <code>sub_workspace_id</code>.
3. Send a DELETE request to the <code>/workspace-group-members/:id</code> endpoint, replacing <code>:id</code> with the appropriate ID.
4. The sub-workspace is removed immediately.

Click the Leave workspace group button under the Admin workspace section. The workspace leaves the group immediately.

1. Navigate to Settings &gt; <a href="https://app.instantly.ai/app/settings/account" rel="nofollow noopener noreferrer" target="_blank">Account</a>.
2. Go to the Workspace Group tab.
3. Click the Leave workspace group button under the Admin workspace section. The workspace leaves the group immediately.

Call the GET <code>/workspace-group-members/admin</code> endpoint.

Retrieve the <code>workspace_group_member_id</code>.

Send a DELETE request to the <code>/workspace-group-members/:id</code> endpoint, replacing <code>:id</code> with the <code>workspace_group_member_id</code>.

The workspace leaves the group immediately.

1. Call the GET <code>/workspace-group-members/admin</code> endpoint.
2. Retrieve the <code>workspace_group_member_id</code>.
3. Send a DELETE request to the <code>/workspace-group-members/:id</code> endpoint, replacing <code>:id</code> with the <code>workspace_group_member_id</code>.
4. The workspace leaves the group immediately.

- A workspace cannot be both an admin and a sub-workspace simultaneously.
- Only workspace owners and admins can manage sub-workspaces.
- Only workspace owners can leave a workspace group.

For more details about Workspace API endpoints, check our API documentation here: <a href="https://developer.instantly.ai/workspace-group" rel="nofollow noopener noreferrer" target="_blank">https://developer.instantly.ai/workspace-group</a> ​

Organize multiple workspaces under one Admin workspace

Adding Sub-Workspaces

From the Instantly platform

Via API

Removing Sub-Workspaces

From the Instantly platform

Via API

Leaving a Workspace Group

From the Instantly platform

Via API