# Inviting users and defining roles

This page provides an overview of user management in Welkin. Detailed step-by-step instructions are in the Administration section (accessible from the left sidebar).

## How user access works

In Welkin, every person who logs in is a **User** assigned one or more **Roles**. Roles control:

* Which patients the user can view (only their assigned patients, or all patients)
* Which features and modules they can access
* What actions they can take (view, edit, or full access per feature)
* Which regions they can access

Getting roles right before inviting users is important – it avoids having to retroactively adjust permissions for everyone.

## Getting started with users

Follow these guides in order:

1. **Define your roles** – Before adding anyone, design the role structure for your organization. See [Setting up Welkin Users](https://github.com/welkincloud-io/welkin-docs/blob/master/docs/admin/users.md).
2. **Add users** – Invite team members and assign them roles. See [Add, Delete, Modify Users](https://github.com/welkincloud-io/welkin-docs/blob/master/docs/admin/add-new-users.md).
3. **Grant Designer access** – If any users need to configure the Designer portal, see [Granting Designer Portal Access](https://github.com/welkincloud-io/welkin-docs/blob/master/docs/admin/designer-user-access.md).
4. **Assign seats and licenses** – See [Assigning Seats and Licenses](https://github.com/welkincloud-io/welkin-docs/blob/master/docs/admin/assign-seats-and-licenses-to-new-users.md).

## Common role structure

Most organizations create at minimum:

| Role            | Typical access                             |
| --------------- | ------------------------------------------ |
| Care Manager    | Own patients only; full Care portal access |
| Care Supervisor | All patients in region; no Admin           |
| Administrator   | Full Admin configuration access            |

Adjust these to match your care team structure. For detailed role configuration, see the Administration section in the left sidebar.


---

# 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.welkinhealth.com/getting-started/inviting-users-and-roles.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.