> 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.md).

# Users

A **user** (contact) is a person in your project's membership directory, with one or more linked logins (identities), a profile, roles, and a lifecycle (invited → verified → active → blocked/deleted).

<figure><img src="/files/O4U7aTUWwtuNpG3kmpqG" alt=""><figcaption><p>Membership → Users.</p></figcaption></figure>

## What you can do here

The list shows every person with their **Display Name**, **Primary Email**, **Primary Phone**, **Lifecycle**, and **Created** date. **Add New** opens the [create screen](/cloud/membership/users/new.md), where you invite a user by email, create a login directly (email, username, or phone based), or register a **service user** with an API key for server-to-server access.

Opening a person shows the [detail screen](/cloud/membership/users/edit.md): their profile, assigned **roles**, **marketing preferences**, and the logins they authenticate with. Login-level actions — **block / unblock**, **verify**, **delete** — live on the login form.

Merging duplicate contacts and managing identities (adding, promoting, removing email addresses or phone numbers) is done from code — see the SDK reference below.

## Use it from code

[Membership → Users](/sdks-and-cli/membership/users.md) — 36 methods, from `inviteUser` to `mergeContacts`.

## API reference

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