# Onboarding and Organisation Setup

### Invitation emails

Organisations are managed by Organisation Administrators. Organisation Administrators gain access to an Organisation via an invitation email. The first Organisation Administrator to join an Organisation will receive an invitation email from a Tenant Administrator. Subsequent Organisation Administrators can be invited by existing Organisation Administrators.

To accept an invitation email, navigate to your email inbox. Locate the email sent from *SVX Support* with the subject heading *Invite to join (Organisation name) Organisation*.

#### First time invitation to the SVX Portal

If this is your first invitation to join SVX, the email will contain:

* The name of the person who invited you, and
* Steps on how to access the SVX Portal. These steps include:
  * Navigating to the registration URL
  * Entering your temporary password
  * Setting a new password

After clicking on the registration URL, you will be presented with the SVX registration screen. Enter the temporary password that was provided to you, set your new password and accept Meeco’s [Privacy Policy](https://www.meeco.me/privacy-policy) and [Terms and Conditions](https://www.meeco.me/terms). Click *Next* to log in. You will be asked to set up your Organisation's Passphrase. See the section below titled [Setup the Organisation's Passphrase](#setup-an-organisations-passphrase) for more information.

<div align="center"><img src="/files/NLYXHVjRduGOfuuxWha1" alt="How to login to the SVX Portal tutorial video." width="80%"></div>

#### Subsequent invitations to the SVX Portal

It is possible for an Organisation Administrator to be invited to join other Organisations or Tenancies. In this case, the SVX Portal will recognise the Organisation Administrator as an existing user. All subsequent invitation emails will state:

* Which Tenant or Organisation you have been invited to join
* The name of the person who invited you
* A URL to access the SVX Portal, and
* A reminder to use your existing login details

After clicking on the *Portal Login* URL you will be presented with the SVX login screen. Enter your email address as your username, then enter your password. Click *Log in* to continue to the SVX Portal. You will land on the Tenant / Organisation selection screen. Click on your Tenant or Organisation to navigate to the associated Dashboard.

If you have been invited to an Organisation, after clicking on the Organisation in the list, you will be prompted to enter the associated *Passphrase*. See the section below titled [Setup the Organisation's Passphrase](#setup-an-organisations-passphrase) for more information.

<div align="center"><img src="/files/q6rcLIZx0iereR9tyHcz" alt="How to login to the SVX Portal as an existing user tutorial video." width="80%"></div>

### Set Up an Organisation’s Passphrase

#### First Administrator to join the Organisation

If you are the first Organisation Administrator from your Organisation to login to the SVX Portal you will be presented with the option to set up your Organisation’s Passphrase. This passphrase is unique to your Organisation and ensures that only Organisation Administrators who have entered the passphrase will be able to access all available features and functions. With this in mind, if you decide to set up your Organisation’s passphrase at this point in time, please consider the following:

You will need to distribute the passphrase to other Organisation Administrators who wish to access all features and functions within the Portal.

To set up the Organisation's passphrase, first read the information presented on the setup screen. Click on *Continue* to proceed to the passphrase or *Skip* to navigate to the Organisation's dashbaord. After clicking *Continue* you will be presented with the partially hidden passphrase in a non-editable text field. You can click on the eye 👁 icon to reveal the entire passphrase. Next, click on the *Copy Passphrase to clipboard* button then click *Next*. Paste the passphrase in the empty text field and clik the *Done* button.

A modal will appear confirming that passphrase setup is complete. Click *OK* to close the modal and navigate to the Organisation's dashboard.

> **Note**\
> If you lose the passphrase it is not retrievable and access to your Organisation will be lost. Please only share the passphrase with known users who require access to the Organisation via SVX.

You can choose to skip set up of the passphrase, however you will have limited access to the components within the Portal.

> **Note**\
> If you skip set up of your Organisation's passphrase, you can add the passphrase at a later date. For more information, see the section below titled [Subsequent Portal Sessions](#subsequent-portal-sessions).

<div align="center"><img src="/files/q2Vm1fQtNH1RrDDFG69s" alt="How to setup an Organisation&#x27;s passphrase as the first Administrator tutorial video." width="80%"></div>

#### Subsequent Administrators

If you are invited to join the Organisation and the associated passphrase has already been set up, you will need to enter the Organisation's passphrase when you first try to access the Organisation.

After actioning an invitation email or by clicking on a new Organisation that appears in your Organisations list, you will be prompted to enter the Organisation's passphrase. To do this, acquire the passphrase from another Organisation Administrator, click in the text box on the Passphrase screen, then click the *Login* button. You will be navigated to the Organisation's dashboard.

You can choose to skip setup of the passphrase by clicking on the *Skip for now* button, however, you will have limited access to the components within the Portal.

<div align="center"><img src="/files/Fa13rcK5xzgwkst3lKd2" alt="How to setup an Organisation&#x27;s passphrase as a subsequent Administrator tutorial video." width="80%"></div>

#### Subsequent Portal Sessions

If you have been invited to join an Organisation, and have logged in but *skipped* the passphrase setup step, it is possible to add the Organisation's passphrase during the current or subsequent session. To do this, navigate to *Manage Organisation* and click on *Account settings*. Click on the *Authorization* tab and enter the Passphrase in the corresponding field. Click on the *Confirm Passphrase* button. A confirmation toast message will appear on successful entry of the Organisation's passphrase.

<div align="center"><img src="/files/r4gvgtelrIsWU4CsEBLH" alt="How to setup an Organisation&#x27;s passphrase after skipping the original set up step video." width="80%"></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meeco.me/guides/portal-tutorials/organisation-administrators/onboarding-and-organisation-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
