> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md).

# Find user to add

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/groups/find-user.md).
{% endhint %}

Find people to add to a group: Snapfix users in the user's network, a new person by phone number or email, or an invitation; iOS also lists the phone's contacts here.

* **Where:** iOS and Android: Group settings, the Users tab, the add button (header "Add users to: {group}" on iOS, "Add users to : {group}" on Android)
* **Who:** admins of the group and users with "Add or Remove Users in Group" (`perBusSettingsEditUser`); the Users tab shows the add button only to them
* **Feature:** [Group members](https://docs.snapfix.com/product/features/groups/group-members.md)

On Android this is the Users tab's add screen, which doesn't read the phone's contacts; the screen that does opens only after a new group is saved ([Add from phone contacts](https://docs.snapfix.com/how-the-apps-work/screens/groups/phone-contacts.md)) \[[ASK-78](https://github.com/snapfix/docs/blob/main/ASK.md#ask-78-should-androids-users-tab-add-screen-offer-phone-contacts)].

## Layout

### iOS

"Add users to: {group}", a search field, a choice between Snapfix users only and the phone's contacts as well, a button to add a new user, the list of people, the selected people ("Selected users"), and buttons to finish and to clear the selection. The phone's contacts load once access is allowed.

### Android

The toolbar "Add users to : {group}" with an info button ("Add users", "Users who are already part of your network are shown in this list and can be directly added to the group. Other Snapfix users can be added through the "Add new user" option."), then:

1. A search field.
2. "Invite via link", which opens the share sheet with an invitation ("Invitation to Snapfix").
3. "Add a New User", for a phone number or email.
4. The Snapfix users of the network, or "User not found in your network".
5. "Selected users" and "Done".

## Inputs

| Field                    | Type                  | Required         | Default | Rules and messages                                                                                                                                  |
| ------------------------ | --------------------- | ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search                   | Text                  | No               | Empty   | Filters the people by name, username and mobile number.                                                                                             |
| People                   | A tick per person     | Yes, to add      | None    | A person already in the group: "This user is already added to this group."; a person already ticked: "The user is already selected for this group". |
| Snapfix users only (iOS) | Choice                | No               | —       | Hides the phone's contacts.                                                                                                                         |
| New user                 | Phone number or email | Yes, in its form | Empty   | Looked up in Snapfix; a match joins the selection, no match leads to an invitation.                                                                 |

## Actions

| Action                | Who                  | What happens                                                                                                                                                                                                                      | API                                                                                                     |
| --------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Tick a person         | Users with the right | Adds the person to the selection; tapping again removes them.                                                                                                                                                                     | -                                                                                                       |
| Add a new user        | Same                 | Opens the phone-or-email form. When the plan has no users left, the screen says "No new users left in this account." with a "Learn more" link that opens a missing help page.                                                     | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md)                                |
| Invite                | Same                 | Android "Invite via link": the system share sheet with the invitation; nothing is saved on the server. Named invitations go out from the invite sheet ([Users API](https://docs.snapfix.com/engineering-reference/api/users.md)). | -                                                                                                       |
| Check contacts (iOS)  | Same                 | Sends the contacts' usernames and numbers to find the ones who already use Snapfix.                                                                                                                                               | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md) (`?action=validate_usernames`) |
| "Done"                | Same                 | Adds the selected Snapfix users to the group on the device and syncs; Android then says "User added to group, and notification sent".                                                                                             | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md)                                |
| Back with a selection | Same                 | Asks "You have selected one or more users. Do you wish to add them to the group?"                                                                                                                                                 | -                                                                                                       |

## States

* **Loading:** a wait indicator while the network and the contacts load.
* **Empty:** Android: "User not found in your network".
* **No permission:** without the right, the add button isn't shown. iOS without contacts access: "You have restricted access to contacts. Please enable access in Settings." and only Snapfix users are listed.
* **Offline (mobile):** the network list comes from the device; looking up a new person and sending invitations need a connection.

## Dialogs and sheets

* **New user** (phone or email) and **Invite** sheets.
* **Add confirmation** on back, as above.
* **Share sheet** with "Invitation to Snapfix".

## Platform differences

* **Phone contacts:** iOS lists them on this screen; Android only after a new group is saved \[[ASK-78](https://github.com/snapfix/docs/blob/main/ASK.md#ask-78-should-androids-users-tab-add-screen-offer-phone-contacts)].
* **Invite by link:** Android has "Invite via link" here; iOS invites from its contacts and new-user flows.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
