> ## Documentation Index
> Fetch the complete documentation index at: https://docs.megaport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inviting Users to Your Account

> This help topic describes how a Company Admin can invite other users to their Megaport account.

export const Image = ({src, alt = '', caption, width, height, shadow}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Image -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  const img = <img className={['mega-image-style', shadow ? 'shadow' : ''].join(' ')} src={src} alt={alt} width={width} height={height} style={{
    display: 'block'
  }} />;
  return caption ? <figure>
      {img}
      <figcaption style={{
    textAlign: 'center',
    width
  }}>{caption}</figcaption>
    </figure> : img;
};

export const InlineImage = ({src, alt, height = 16, shadow, width}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: InlineImage -';
  if (typeof src !== 'string') {
    src = String(src);
  }
  if (!src || src === 'undefined') {
    console.error(`${errorPrefix} \`src\` is required — rendering an empty string instead`);
    return <></>;
  }
  if (typeof alt !== 'string') {
    alt = String(alt);
  }
  if (alt === 'undefined') {
    console.error(`${errorPrefix} \`alt\` is required (use "" for decorative images) — rendering an empty string instead`);
    return <></>;
  }
  if (height) {
    height = height.toString().replaceAll(/\D/g, '');
  }
  if (width) {
    width = width.toString().replaceAll(/\D/g, '');
  }
  return <img className={['inline-icon', shadow ? 'shadow' : null, 'm-0'].filter(Boolean).join(' ')} src={src} alt={alt} height={height} width={width} style={{
    display: 'inline',
    verticalAlign: 'middle',
    maxHeight: height ? `${height}px` : undefined,
    maxWidth: width ? `${width}px` : undefined,
    height: height ? `${height}px` : undefined,
    width: width ? `${width}px` : undefined
  }} />;
};

export const Link = ({href, children}) => {
  const errorPrefix = '\x1b[31;1;4mERROR\x1b[0m: Link -';
  if (typeof href !== 'string') {
    href = String(href);
  }
  if (!href || href === 'undefined') {
    console.error(`${errorPrefix} the \`href\` property is required — rendering an empty string instead`);
    return <></>;
  }
  if (href.includes('{') || href.toUpperCase().includes('%7B')) {
    console.error(`${errorPrefix} could not resolve a variable in href "${href}" — rendering an empty string instead`);
    return <></>;
  }
  const isExternal = (/^https?:\/\//).test(href);
  return <a href={href} className="link" target={isExternal ? '_blank' : undefined} rel={isExternal ? 'noreferrer' : undefined}>
      {children ?? href}
      {isExternal && <span className="sr-only"> (opens in a new tab)</span>}
    </a>;
};

A Company Admin can create new user accounts by inviting users to the company account from the Megaport Portal.

Invited users will receive an introductory email with information about accessing the Megaport Portal. This email will include a temporary password that can be used to log in, after which the user must set a new password that meets the minimum security requirements. The temporary password is valid for up to 24 hours. After this time, you will need to resend the introductory email to issue a new temporary password. You can also resend the introductory email at any time before the 24-hour limit, if required.

If Single Sign-On (SSO) has been enabled for your account (an IdP connection has been created), and the email domain is associated with a registered SSO domain, the email will contain a link that must be clicked to confirm the user for the account. Invited users will not be able to log in if they have not clicked this link.

You can also delete invited users if they do not activate their account and change their password.

<Callout icon="triangle-exclamation" color="red">
  When a Google user is invited to an account by a Company Admin, that user will be sent a temporary password and is required to log in directly through a username and password, then reset the account password. This will create their account, and later allow them to log in using a username and password or their Google account. If the user doesn't use the username and password method for the first login with the temporary password then the account will not be created correctly, and the user won't be able to log in using Google credentials.
</Callout>

**To invite other users to your account**

1. Visit the <Link href="https://portal.megaport.com">Megaport Portal</Link> and log in.

2. Choose User Menu > Admin Settings > Manage Users.
   <Image src="/images/setting-up/invite-users-add-new-user.png" alt="Add new users to your account" shadow={true} width={800} />

3. Click **New User**.
   <Image src="/images/setting-up/invite-users-add-user-screen.png" alt="Add new user screen" shadow={true} width={600} />

4. Complete these fields:
   * **First Name** -- The first name of the user being invited to your account.

   * **Last Name** -- The last name of the user being invited to your account.

   * **Email** -- The email address of the user being invited to your account.\
     The email address must be unique and cannot be from a free email domain (such as Gmail, Yahoo, or Outlook).\
     Megaport will send the user an email to this address with a temporary password for logging in to the Megaport Portal.

     <Note>
       When SSO is enabled (an IdP connection has been created), and the email domain is associated with SSO, the user will be sent an email containing a link that must be clicked to confirm the user for the account. If the email domain is not associated with SSO, the standard invite email will be sent with a temporary password for logging in.\
       Users from other domains can be added, however, a pop-up message will show during creation warning that the user won't be able to log in unless they are a Company Admin.\
       For more information, see [Setting up Single Sign-On](/setting-up/enforcing-sso).
     </Note>

   * **Phone** -- The phone number of the user being invited to your account. Enter this phone number in international format, for example, +61 4321 1234.

   * **Role** -- Select the Megaport user role to assign to the invited user.\
     A brief description of the selected role is displayed.

     <Tip>
       Click the **View all user actions** link in this screen to learn more about the supported functionality of each role.
     </Tip>

5. Click **Save**.\
   Complete these steps for each user that you want to invite to your account. When you create a new user, the user is sent an email with instructions for logging in or confirming the user account.

**To resend the invitation email**

When an account has not been activated, a **Resend Invite** button is available on the Edit User page.

If you need to resend the invitation email, use these instructions.

<Note>
  You must be a Company Admin to resend the invitation email.
</Note>

1. Visit the <Link href="https://portal.megaport.com">Megaport Portal</Link> and log in.

2. Choose User Menu > Admin Settings > Manage Users.
   <Image src="/images/setting-up/invite-users-add-new-user.png" alt="Manage users page" shadow={true} width={800} />

3. Locate the user to edit then click <InlineImage src="/images/setting-up/view-user-button.png" alt="View users button" height={30} />(View User).

4. Click **Resend Invite** to resend the invitation email.
   <Image src="/images/setting-up/resend-email.png" alt="Manage user page with resend invite button." shadow={true} width={800} />

5. A pop-up window will appear asking for confirmation. Click **OK**.

   <Image src="/images/setting-up/resend-email-sure.png" alt="Manage users page" shadow={true} width={400} />

   A message will appear telling you that the email has been resent.

**To delete invited users**

A Company Admin can delete invited users if they haven't activated their account and successfully logged in.

1. Visit the <Link href="https://portal.megaport.com">Megaport Portal</Link> and log in.
2. Choose User Menu > Admin Settings > Manage Users.
   <Image src="/images/setting-up/invite-users-add-new-user.png" alt="Manage users page" shadow={true} width={800} />
3. Locate the user to delete.\
   Use the filter field at the top of the page to quickly find the user by name.
4. Click <InlineImage src="/images/setting-up/delete-user-icon.png" alt="Delete user" height={30} />(Delete).

   <Image src="/images/setting-up/delete-invited-user-sso.png" alt="Delete invited user" shadow={true} width={700} />

   If the user was invited and never logged in to the Megaport Portal, they will be deleted.

   <Note>
     * If the user was invited and has logged in, the Delete button will no longer be available. You need to edit and deactivate the user instead.
     * Users that have been invited and not accepted, then deleted, can be re-invited using the same email address. The same email address can also be used where an accepted user has been deactivated (however once the email address is re-used, the initial user who was marked as *Inactive* cannot be re-activated).
   </Note>

## Accepting an invite to your Megaport account

If a Company Admin of your Megaport account has sent you an email inviting you to the account, you can accept the invite and confirm your user account.

<Note>
  You might receive different invitation emails depending on the security policies set by the Company Admin. If SSO has been enabled, and the email address is associated with an SSO domain, you will receive an email with a link asking you to confirm your user account. Otherwise, you will receive an email with a temporary password.
</Note>

**To accept an invite to your Megaport account (username and password)**

This is the invite you will receive when your company requires you to log in to Megaport using a username and password. You will also receive this email if SSO is set up on the account, SSO is set to optional, and you have an email address that isn't associated with an SSO registered domain.

1. In the invitation email you received, click the link to log in.
   <Image src="/images/setting-up/invite-users-log-in-unpw.png" alt="Click link to log in" shadow={true} width={600} />

2. In the <Link href="https://portal.megaport.com">Megaport Portal</Link>, log in using your email and temporary password that was sent in the email to you.\
   Enter your email > click Continue > enter your password > click Continue.
   <Image src="/images/setting-up/invite-users-login-temp-password.png" alt="Log in with temporary password" shadow={true} width={350} />
   You are prompted to reset your password.

3. In the Reset Password screen, enter your new password and then confirm the new password.

   <Note>
     The Megaport Portal password policy includes minimum password complexity rules. Your new password must contain:

     * At least 8 characters
     * Uppercase characters (A-Z)
     * Lowercase characters (a-z)
     * Numbers (0-9)
     * At least one special character: ^ \$ \* . \[ ] {} ( ) ? " ! @ # % & / \ , > \< ' : ; | \_ \~ \` = + -

     The password policy uses a password strength estimator to prevent common, easily guessed passwords, such as Passw0rd. If you have met all complexity requirements and your password is still being rejected, the likely cause is that the password is too common or easy to guess.
   </Note>

4. Click **Reset Password**.\
   The Password Changed OK prompt appears.

5. Click **OK**.\
   You are now confirmed as a new user and logged in to the Megaport Portal with your new password.

**To accept an invite to your Megaport account (SSO)**

This is the invite you will receive where you are invited to an account that has SSO enabled, and your email address is associated with one of the configured SSO domains.

* In the invitation email that you received, click **Complete Account Setup** to confirm your user account.
  <Image src="/images/setting-up/invite-users-log-in-sso.png" alt="Click link to log in" shadow={true} width={600} />
  You are now confirmed as a new user and logged in to the Megaport Portal.
