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

# Sign in and create your account

> Create a dental clinic, verify your email, sign in with a password or Google, choose the clinic you work in and accept an invitation.

Everything in muveya happens inside a **dental clinic** account (the API calls it a tenant). You reach it at `console.muveya.com` with a personal account: an email address plus a password, or your Google account. One personal account can belong to several dental clinics, and you choose which one you are working in after you sign in.

There are two ways to get a personal account:

* **Create a dental clinic.** You register, and muveya creates your account and a new dental clinic where you are the **Owner**.
* **Accept an invitation.** Someone who manages a team invites you by email, and you join their dental clinic with the access they chose. See [Accept an invitation](#accept-an-invitation).

<Info>
  The sign-in screens have no permission requirements: anyone can open them. What you can do after you enter depends on your role, your permissions and your locations. See [Roles and permissions](/docs/en/account/roles-and-permissions).
</Info>

## Create a dental clinic

**Who can do it:** anyone with an email address that does not already have a muveya account.

**Where:** on the sign-in screen, select **Create a dental clinic** (below **New to muveya?**), or open `console.muveya.com/register`. The screen is titled **Set up your dental clinic**.

<Steps>
  <Step title="Fill in the form">
    Enter **Your name**, **Email address** and **Dental clinic name** (the hint says **Use the name of your dental clinic.**).
  </Step>

  <Step title="Create the clinic">
    Select **Create a dental clinic**. The screen changes to **Check your email** and names the address the link was sent to.
  </Step>

  <Step title="Open the verification email">
    Open the email and select **Verify email**. Continue in [Verify your email and choose your password](#verify-your-email-and-choose-your-password).
  </Step>
</Steps>

| Field | Rules |
| - | - |
| **Your name** | Required, up to 200 characters. |
| **Email address** | Required, a valid email address, up to 320 characters. It is stored in lowercase. |
| **Dental clinic name** | Required, up to 200 characters. Two clinics may share a name. |

The emails muveya sends you (verification, password) are written in the language the console is showing when you register.

**What the system records**

* Your personal account, not yet verified, with no password.
* A new dental clinic with you as its only member, with the **Owner** role and access to **All locations in this account** and **All warehouses in this account** (including the ones created later).
* A verification link that is valid for 24 hours.

Registration does not sign you in. You sign in after you choose your password.

<Warning>
  A new owner starts with the permissions the Owner role includes: read and manage the catalog, manage team access and manage clinic configuration. Inventory, orders, approvals, deliveries and reports are **not** included in any role. Before you operate, open **Team**, select your own name and tick the permissions you need. See [Roles and permissions](/docs/en/account/roles-and-permissions).
</Warning>

## Verify your email and choose your password

**Where:** the link in the email opens `console.muveya.com/verify-email`.

<Steps>
  <Step title="Open the link">
    Select **Verify email** in the email. The console confirms the address and shows **Choose your password** with the text **Your email is verified. Set a password for your account.**
  </Step>

  <Step title="Choose the password">
    Enter it in **New password** and again in **Confirm password**. You can use **Show password** to check what you typed, and paste it from a password manager.
  </Step>

  <Step title="Save it">
    Select **Save password**. The screen shows **Password ready**. Select **Back to sign in** and sign in with your email and the new password.
  </Step>
</Steps>

**Password rules:** required, up to 200 characters, and it must pass a strength check. A weak password is refused with **Check the entered values and try again. If you are choosing a password, use a stronger, unique password.** muveya does not store your password: the identity provider keeps it.

<Note>
  The link is single use and the console removes it from the address bar as soon as it opens. If you reload the page or close it before saving the password, the link no longer works. Request a new one (next section): because your email is already verified, the new email is **Set your password** and its **Set password** button takes you straight to **Choose your password**. That link is also valid for 24 hours.
</Note>

### Request a new verification link

1. On the sign-in screen, select **Need to verify your email?**. The screen is titled **Verify your email**.
2. Enter your **Email address** and select **Resend verification email**.
3. The screen shows **If your account needs verification, an email is on its way. Check your inbox and spam folder.**

On **Check your email** (right after registering) the same action is the **Resend verification email** button.

The answer is always the same, whether or not the address has an account, so the screen never reveals who is registered. muveya sends at most one new link per minute for the same address; if you ask again before that minute has passed since the last link was sent, the request is accepted but nothing is sent. Each new link replaces the previous one.

## Sign in with email and password

**Where:** `console.muveya.com/login`, titled **Sign in to your account**.

<Steps>
  <Step title="Enter your credentials">
    Enter your **Email address** and **Password**.
  </Step>

  <Step title="Add your verification code, if you use one">
    If you set up an authenticator app (see [Account security](/docs/en/account/security)), open **I have a verification code** and type the six digits from the app in **Verification code**.
  </Step>

  <Step title="Sign in">
    Select **Sign in**. You land on **Choose a dental clinic**, or back on your invitation if you were accepting one.
  </Step>
</Steps>

<Warning>
  Once your account has an authenticator, every password sign-in needs the code. Without it, or with a wrong code, the sign-in is refused with the same message as a wrong password: **Check your email, password and verification code, if you use one. Then try again.**
</Warning>

**Rules and limits**

* The code is exactly six digits. Anything else shows **Enter a six-digit verification code.**
* An account whose email is not verified, or whose password was never set, cannot sign in. The message is the same as for a wrong password, on purpose.
* After 10 failed attempts for the same email from the same network within 15 minutes, sign-in for that email and network is blocked for 15 minutes: **There have been too many attempts. Wait a few minutes before trying again.** A successful sign-in clears the counter.

There is no "forgot password" screen yet. If you cannot sign in with your password, write to [team@muveya.com](mailto:team@muveya.com).

## Sign in with Google

**Where:** **Continue with Google**, below **or continue with**, on the sign-in and registration screens.

The button appears only when Google sign-in is available. While the console checks, it shows **Loading sign-in options…**. If the check fails you see **Google sign-in is temporarily unavailable. You can use your email below.** and a **Try again** button.

<Steps>
  <Step title="Start">
    Select **Continue with Google** and choose your Google account on Google's page.
  </Step>

  <Step title="Come back to muveya">
    Google returns you to `console.muveya.com/oauth/callback`. What happens next depends on your account (table below).
  </Step>
</Steps>

You have 10 minutes from the moment you select the button to finish the whole round trip, including the screens below.

| Your situation | What you see | What to do |
| - | - | - |
| A muveya account with the same email exists and is set up | You are signed in and land on **Choose a dental clinic**. | Choose your clinic. |
| That account has an authenticator | **Verify your identity**, with **Enter the six-digit code from your authenticator app.** | Type the code in **Verification code** and select **Verify code**. |
| No muveya account uses that email | **Set up your dental clinic**, with **Your Google account is verified. Confirm the name of your dental clinic.** and your Google email. | See [Create a dental clinic with Google](#create-a-dental-clinic-with-google). |
| The account exists but its email is not verified or its password setup is unfinished | **This link is no longer available** | Finish [Verify your email and choose your password](#verify-your-email-and-choose-your-password) first. |
| The 10 minutes ran out, or you reloaded the page | **This link is no longer available** and **This link expired or has already been used. Start again with a new link.** | Select **Back to sign in** and start again. |

A wrong authenticator code shows **Check the code in your authenticator app and try again. If the attempt expired, start a new sign-in.** You can try again within the same 10 minutes.

### Create a dental clinic with Google

This is the registration confirmation you see when your Google email has no muveya account yet.

1. Check the Google email shown under the title.
2. Enter the **Dental clinic name** (required, up to 200 characters).
3. Select **Create a dental clinic**.

muveya creates your personal account and the dental clinic exactly as in [Create a dental clinic](#create-a-dental-clinic), except that Google has already verified your email: there is no verification email and no password step, and you are signed in right away. Your name is taken from your Google profile (or from the part of your email before the `@` when Google does not share it).

<Note>
  An account created with Google has no muveya password. Keep using **Continue with Google** to sign in.
</Note>

## Choose a dental clinic

**Where:** `console.muveya.com/workspaces`, titled **Choose a dental clinic** with **Select the dental clinic you want to work in.** Your email address is shown under the title.

After every sign-in you land here. The list shows every dental clinic where your membership is active. Each row shows the clinic name and an action:

* **Continue** on the clinic that is already active in your session.
* **Enter** on the others.

Select the row to work in that clinic. If you were sent to sign in from a specific page, you return to that page after choosing.

| What you see | Why | What to do |
| - | - | - |
| **No dental clinics available** and **Your account has no active dental clinic access. Ask an administrator to review your invitation or membership.** | You have no active membership: you were never added, you were suspended or removed, or you have not accepted your invitation yet. | Ask the person who manages the team. **Sign out** is on the same screen. |
| **We could not load your dental clinics** | The list could not be loaded. | Select **Try again**. |
| **This dental clinic is no longer available to your account. Choose another clinic.** | Your membership in that clinic ended after the list was loaded. | Choose another clinic. |

A suspended or removed membership does not appear in the list.

### Switch to another dental clinic

* On a computer, use the **Dental clinic** selector at the top of the sidebar. Choosing another clinic takes you to **Home** of that clinic.
* From **Home**, select **Choose a dental clinic** to open the full list.

The switch applies to your session, so every open tab of the console follows it. A tab that was showing the previous clinic reloads its content and shows **The active dental clinic account changed in another tab. Nothing you were entering here was sent: check it in this account before you continue.** Select **Close** after you have checked.

## Change the language

The console is available in English, Español and Português. Use the **Language** selector:

* at the bottom of the sign-in, registration and clinic selection screens;
* in the sidebar, above your email address, on a computer;
* in the top bar on a phone.

The console first follows your browser's language (English when it is not one of the three) and then remembers your choice in this browser. The language does not change for other people. Invitation emails use the language the inviter chose in **Email language**.

## Sign out

Select **Sign out**. It is in the sidebar under your email address, at the bottom of the menu on a phone, and on the clinic selection screen. muveya ends your session on the server and returns you to the sign-in screen.

## How long a session lasts

* A session ends after 30 minutes without activity.
* A session ends 30 days after sign-in, even if you keep working.
* A person who manages the team can end your sessions by suspending you, removing you or changing your role (see [Team](/docs/en/account/team)).

When your session ends, the console sends you to the sign-in screen. After you sign in and choose the clinic, you return to the page you were on. Nothing you had typed but not saved is sent.

## Accept an invitation

When someone invites you, you receive an email titled **You’re invited to a clinic on muveya** with an **Accept invitation** button. The link opens `console.muveya.com/invitations/accept` and is valid for 24 hours from when it was sent. A newer email for the same invitation replaces the older link.

<Info>
  Opening the link, verifying your email or signing in never accepts anything. You join the clinic only when you select **Accept invitation** on the review screen.
</Info>

The first screen shows **Join the team at** followed by the clinic name, and **This invitation was sent to** a masked address (for example `a***@clinicanorte.com`) with the expiry date. It also says **If you don’t recognize this invitation, don’t continue.** What you do next depends on whether you already have an account.

<Tabs>
  <Tab title="I am new to muveya">
    <Steps>
      <Step title="Create your account">
        Select **Create my account**. muveya sends a second email, **Confirm your email to join the clinic**, and the screen shows **Check your email**: **We sent a verification link to** your masked address, **Open it in this same browser within 10 minutes.**
      </Step>

      <Step title="Confirm your email">
        In the same browser, open the email and select **Confirm email**. If it does not arrive, select **Send the link again** (at most once a minute).
      </Step>

      <Step title="Choose your name and password">
        The screen **Create your account** says **Your email is verified. Enter your name and choose a password.** Fill in **Your name** (up to 120 characters), **New password** and **Confirm password**, then select **Create account**.
      </Step>

      <Step title="Review and accept">
        Continue with [Review and accept](#review-and-accept). After you accept, you are signed in to the new clinic.
      </Step>
    </Steps>
  </Tab>

  <Tab title="I want to use Google">
    <Steps>
      <Step title="Continue with Google">
        Select **Continue with Google** on the invitation screen (it appears when Google sign-in is available). Choose the Google account whose email is exactly the invited address.
      </Step>

      <Step title="Review and accept">
        Google's confirmation replaces the email check, so you go straight to [Review and accept](#review-and-accept). No new dental clinic is created. After you accept, you are signed in to the clinic.
      </Step>
    </Steps>

    If you choose a Google account with a different email, you see **This invitation is for a different account. Use the account that received the invitation.** Try again with the right Google account.
  </Tab>

  <Tab title="I already have an account">
    <Steps>
      <Step title="Sign in">
        Select **I already have an account** and sign in with the account that received the invitation (password or Google). You come back to the invitation, titled **Continue your invitation**.
      </Step>

      <Step title="Confirm the account">
        Select **Continue as** followed by your email.
      </Step>

      <Step title="Review and accept">
        Continue with [Review and accept](#review-and-accept). Your existing session stays open; after accepting, **Enter** takes you to **Choose a dental clinic**.
      </Step>
    </Steps>

    If you are already signed in when you open the link, you see **Continue as** and **Use another account** directly. If the signed-in account is not the invited one, the screen shows **This invitation is for** the invited address **You are signed in as** your current address, and only **Use another account** is offered: it signs you out and takes you to sign in.
  </Tab>
</Tabs>

<Warning>
  For your security, an invitation stays open in your browser for only 10 minutes after each step, and never beyond its own expiry. If you take longer, the screen says **Open your invitation link again** (**For your security, an invitation stays open only for a few minutes. Open the link from the email again.**). Open the link from the invitation email again; it still works while the invitation is valid.
</Warning>

### Review and accept

The screen **Review your access** says that the clinic **offers you this access. Nothing changes until you accept.** and lists:

| Row | What it shows |
| - | - |
| **Account** | The email that will join. |
| **Role** | **Member** or **Administrator**. |
| **Permissions** | The permissions granted on top of the role, or **Only the permissions included in the role**. |
| **Locations** | The granted locations, or **All locations in this account**. |
| **Warehouses** | The granted warehouses, or **All warehouses in this account**. |

Select **Accept invitation**. The screen shows **You joined** followed by the clinic name, and either:

* **Your access is active. You can enter now.** with **Enter**, or
* **Your access is active. Sign in to enter.** with **Sign in**, when your session could not be opened automatically. Sign in normally; the membership is already active.

If you were a member of this clinic before and were removed, accepting a new invitation brings you back with the access in the new invitation.

### Invitation messages

| Message | Meaning | What to do |
| - | - | - |
| **This invitation is not available** (**The link may have expired or been replaced. Ask the person who invited you for a new invitation.**) | The link is unknown, expired, revoked, already used or replaced by a newer email. | Use the most recent email, or ask for a new invitation. |
| **We could not verify your email** (**Open the link in the same browser where you started, within 10 minutes. If it expired, open your invitation link again.**) | The confirmation link was opened in another browser, after 10 minutes, or twice. | Open the invitation link again in one browser and repeat. |
| **This invitation is no longer available. Open your invitation link again or ask for a new one.** | The invitation ended or your 10 minutes ran out during a step. | Open the invitation link again. |
| **This invitation is for a different account. Use the account that received the invitation.** | You proved a different email. | Sign in or choose the Google account with the invited email. |
| **You already have an account with this email. Sign in to continue with the invitation.** | You chose **Create my account** but the email already has an account. | Select **Sign in** and continue as that account. |
| **We are still setting up your access. Try again in a moment.** | Your account is still being prepared. | Wait a few seconds and repeat the action. |
| **We could not finish setting up your access. Ask the clinic administrator for help.** | Account preparation could not complete. | Ask the person who invited you; they may need to send a new invitation. |
| **This invitation needs to be reviewed by the clinic administrator. Ask them to send it again.** | The person who sent it no longer holds the access it grants. | Ask a team manager to create a new invitation. |
| **You already belong to this dental clinic. Sign in to enter.** | Your membership already exists (active or suspended). | Sign in and choose the clinic, or ask to be reactivated. |
| **This account cannot join this dental clinic. Ask the clinic administrator for help.** | This account cannot be linked to that clinic. | Ask the clinic administrator; you may need to use another email. |
| **This invitation changed while you were reviewing it. Open your invitation link again.** | The invitation was resent or revoked meanwhile. | Open the newest invitation email. |
| **We could not check your session** | The console could not tell whether you are signed in. | Select **Try again**. |

## Messages and what to do

These are all the messages the sign-in, registration and verification screens can show.

| Message | When | What to do |
| - | - | - |
| **Enter your email address.** / **Enter a valid email address.** | The email field is empty or malformed. | Correct the address. |
| **Enter your password.** / **Confirm your password.** | A password field is empty. | Fill it in. |
| **Enter your name.** / **Enter the dental clinic name.** | A required field is empty. | Fill it in. |
| **This value is too long.** | A field is over its limit (200 characters for passwords, names and clinic names; 120 for the name when accepting an invitation). | Shorten it. |
| **Enter a six-digit verification code.** | The code is not six digits. | Type the six digits from your authenticator app. |
| **The passwords do not match. Enter the same password in both fields.** | **New password** and **Confirm password** differ. | Type the same password twice. |
| **Check your email, password and verification code, if you use one. Then try again.** | Wrong email or password, missing or wrong code, unverified email or unfinished password setup. | Check each value. If you never finished setup, request a new verification link. |
| **Check the code in your authenticator app and try again. If the attempt expired, start a new sign-in.** | Wrong code on **Verify your identity**. | Use the current code; if 10 minutes passed, start again. |
| **There have been too many attempts. Wait a few minutes before trying again.** | Too many failed sign-ins, or too many requests in a short time. | Wait 15 minutes, then try again carefully. |
| **We could not create this account. Try signing in or request an email verification link.** | The email already has a muveya account. | Sign in, or use **Need to verify your email?** |
| **Check the entered values and try again. If you are choosing a password, use a stronger, unique password.** | A value was refused, usually a weak password. | Choose a longer, unique password. |
| **This link expired or has already been used. Start again with a new link.** (title **This link is no longer available**) | The verification or Google link is expired, used, or was removed by a reload. | Request a new link or start the Google sign-in again. |
| **We could not finish setting up your password. Request a new verification link.** | The password could not be saved with this link. | Request a new link and choose the password again. |
| **We could not complete your access** | An unexpected error interrupted the link. | Select **Back to sign in** and try again. |
| **We could not connect. Check your connection and try again.** | No network. | Check your connection. |
| **The service is temporarily unavailable. Please try again shortly.** | muveya or the identity provider is temporarily unavailable. | Try again in a few minutes. If it persists, write to [team@muveya.com](mailto:team@muveya.com). |
| **This action is not available for your current access. Refresh your session and try again.** | The request was refused for your current session. | Reload the page, sign in again if asked. |

## What you cannot do yet

The console on production has no screen to:

* reset a forgotten password;
* change your email address or your name;
* delete your personal account;
* leave a dental clinic by yourself (ask a person who manages the team to remove you).

For a password, email or name problem, or to leave a clinic, write to [team@muveya.com](mailto:team@muveya.com) from the email address of your account. To delete your personal account, follow section 12 of the [Privacy Policy](https://muveya.com/en/privacy-policy#section-12), which names the privacy address that handles it.

## Legal documents

The sign-in and registration screens link to the **Terms of Service** and the **Privacy Policy** (they open in a new tab, in the console's language). The console does not ask you to accept them in a separate step. See [Security and privacy](/docs/en/trust/security-and-privacy).

## Related pages

<CardGroup cols={2}>
  <Card title="Account security" icon="shield-halved" href="/docs/en/account/security">
    Set up an authenticator app and understand what it protects.
  </Card>

  <Card title="Team" icon="users" href="/docs/en/account/team">
    Invite people and manage their access.
  </Card>

  <Card title="Roles and permissions" icon="key" href="/docs/en/account/roles-and-permissions">
    What each role and permission unlocks.
  </Card>

  <Card title="Troubleshooting" icon="life-ring" href="/docs/en/help/troubleshooting">
    Fixes for common problems.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.