Organizations and Teams

PDF for offline use
Related Articles:

Let us know how you feel about this

Translation Quality


last updated: 2015-11

Test Cloud allows applications and users to be grouped into Organizations, and then Teams within organizations. This guide explains how to create organizations and teams to manage your applications, and also how existing data is migrated to the new structure.


At the core of the Test Cloud hierarchy is an organization. An organization is used to coordinate team, subscriptions, apps, and users. Each organization will have one or more users who are administrators that can create teams. A team is comprised of at least one application and one or more users who are collaborating on applications. Teams have their own API key that will help associate an application and tests with a user account. This hierarchy is depicted in the following diagram:

There are three different types of users:

  • User – this is anybody who is registered with Test Cloud. Typically, users will work on one or more team. It is possible for a user to belong to multiple organizations.
  • Team Managers – these users have the Manage Permissions that are set for a given team. They can add or remove users from a team. A team must always have one team manager.
  • Admin – these are users that are responsible for maintaining an organization. They can create, modify, or delete teams, users, and other administrators. An organization must have at least one administrator.

Once a team has been created, users will upload the mobile application and tests to Test Cloud. Test Cloud uses the combination of the team API key and the user’s e-mail address to associate the upload with the team and enqueue the test run. When the tests have been run, Xamarin Test Cloud will collect the results and send out a notification to users so that they can examine the results.

Existing users of Xamarin Test Cloud will have their accounts converted to organizations and teams, as described in the Transitioning to Organization and Teams guide.

Working with Organizations & Teams

When a Test Cloud account is created, it will automatically have one team with one user created. That user will be both the team manager and the organization administrator. The administrator may go about editing the organization by:

  • Adding or inviting new users
  • Adding more administrators
  • Creating more teams

Adding an Administrator to an Organization

Only existing administrators may add a new administrator to an organization. The following steps describe this process:

  1. Log into Xamarin Test Cloud, and select Account Settings from the drop down menu in the upper right hand corner:

  2. Next, select Organization overview from the left hand menu on the Account page:

  3. On the Organization overview page, click on the New Admin button in the upper right hand corner of the screen:

  4. Enter the e-mail address of the new admin in the text field and press the Enter key or click on the check mark. If the user is already known to Xamarin Test Cloud, an e-mail will be sent notifying that user the change in status. Otherwise, the user will receive an e-mail invitation to register with Xamarin Test Cloud.

    Test Cloud will update the list of administrators:

Deleting an Administrator

To delete an administrator, click on the Gear icon from the Organization overview page, and select Remove from administrators in the menu that appears:

Creating and Editing a Team

Administrators can create teams, add users, edit their permissions, and remove them from a Team. An administrator may also change the name of a team if necessary. A team must have a least one user with Manage Permissions. The team manager may add users to, or remove users from, a team.

To make changes to a team, log into Xamarin Test Cloud, and select Account Settings from the drop down menu in the upper right hand corner:

Then click on the Teams & Apps in the menu on the let hand side of this screen. A list of teams will be displayed:

From this screen it is possible to add, edit or delete a team.

Each team will be displayed in a card. The team card will also hold a collection of applications. It is possible to move applications from team to team by selecting the application in the old team and dragging it to the new team.

Creating a New Team

  1. Scroll to the bottom of the Teams & Apps page, and click on the New team button at the bottom of the page. This will add a new card to the bottom of the page:

The new team will be created with one user (the individual who created it), who will have the Manage Team permissions. A team must always have one user with these permissions.

  1. Click on the settings Gear icon for the new team, in the upper right hand corner of the card for the team. This will bring up a dialog for the team members:

  2. To add a new member to the team, click on the New Member button on the dialog. This will add a new row to the team dialog. Enter the e-mail address of the new team member and click the Add button or hit the Enter key:

  3. When you have finished adding members to a new team, click on the Done button.

Obtaining the Team API Key

To obtain the Team API team, navigate to the Teams & Apps page and click on the show API key link that is the upper right hand corner of the team card:

A dialog will appear showing the API key:

Deleting a Team Member

To delete a team member, click on the X that is beside their name:

Deleting a Team

To delete a team, call up the team dialog by clicking on the Gear icon of a team card.

Then click on the ellipsis (…) in the upper right hand corner and select Delete Team:

You will be prompted to confirm the deletion before Test Cloud will remove the team. Users will automatically be removed from the team as a part of the deletion process.


This guide described the organization and team structure that is used to manage users and apps in Test Cloud. If you are an existing Test Cloud customer and wish to learn more about how your existing Test Cloud account was migrated to the new Organization and Teams, please read the Transitioning to Organization & Teams.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.