> For the complete documentation index, see [llms.txt](https://docs.codemash.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codemash.io/cloud/membership/users/new.md).

# Invite a user

**Where:** Membership → Users → New · `/projects/<project>/membership/users/new`

{% hint style="info" %}
Screenshot TODO — capture comes from testing-plan area **16-membership**.
{% endhint %}

The screen starts with a **Registration type** card picker. The card you pick decides the form below it:

| Card                | What you enter                        | Result                                                                                                                                                           |
| ------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email & password    | Email address, Password, Display Name | An email login is created; the person can sign in right away.                                                                                                    |
| Username & password | Username, Password, Display Name      | A username login, for apps that do not use email addresses.                                                                                                      |
| Phone               | Phone Number, Display Name            | A phone-number login.                                                                                                                                            |
| Invite              | Email address only                    | An invitation email is sent; the person finishes registration themselves.                                                                                        |
| User as a service   | Display Name                          | A service user for machine-to-machine access, with an API key.                                                                                                   |
| Passkey             | —                                     | No form. Passkeys are created on the user's own device, so passkey users sign up through your app; the card links to the passkey settings and integration guide. |

For the Email & password, Username & password, and Phone cards you can also fill optional **Personal Information** (first name, last name, full name, birth date, gender, contact email/phone), an **Address** block, and preferences such as **Language** and **Time Zone**. These same cards, plus User as a service, show a **Roles** picker — toggle "Managed only" to hide system roles.

An invited user gets no roles picker: they start with the role set as **Default user role** in [Settings → Onboarding](/cloud/membership/settings/onboarding.md), and the invitation email template and token expiration come from the same place.

## Example

Invite `ruta.k@acme.com`: pick the **Invite** card, type the email address, press **Save**. Norbix sends the invitation email (template: *User invitation email template*), the link stays valid for the configured *Invitation token expiration (in minutes)*, and the new user appears in the list with lifecycle `Invited` until they complete registration.

## Use it from code

[Membership → Users](/sdks-and-cli/membership/users.md)

## API reference

Endpoints: [Membership → Users](/api-reference/membership/users.md).