> 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/phone-contacts.md).

# Add from phone contacts

{% 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: Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/groups/phone-contacts.md).
{% endhint %}

Pick people from the phone's contacts, or from the user's Snapfix network, to add to a new group, or invite them to Snapfix.

* **Where:** Android: the add-users screen that opens after a new group is saved ("Add users to : {group}"). The Users tab of an existing group opens [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md) instead, whose contacts button is commented out \[[ASK-78](https://github.com/snapfix/docs/blob/main/ASK.md#ask-78-should-androids-users-tab-add-screen-offer-phone-contacts)].
* **Who:** the user who just saved the group, who is its admin. The phone's contacts permission is needed for the contacts.
* **Feature:** [Group members](https://docs.snapfix.com/product/features/groups/group-members.md)

The phone's address book is also uploaded to the server in the background, not from this screen.

## Layout

The toolbar "Add users to : {group}" with an info button, then a search field, "Include phone contacts" (until the permission is granted), the people (Snapfix users from the user's groups, and the contacts), or "User not found in your network", and "Invite User", "Add a New User" and "Done".

## Inputs

| Field               | Type              | Required          | Default     | Rules and messages                                                                                                                                                                                                                                                                                                                 |
| ------------------- | ----------------- | ----------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Contacts permission | System permission | Yes, for contacts | Not granted | The app explains: "To easily share messages with your team and contacts, Snapfix to access your contacts. Tap Goto Settings > Permissions, and turn your contacts on." A refusal shows "Permission Denied"; when the system blocks the request, a dialog sends the user to settings ("Tap on Permissions and allow permissions."). |
| Search              | Text              | No                | Empty       | Filters the people by name and number.                                                                                                                                                                                                                                                                                             |
| People              | A tick per person | No                | None        | People already in the group can't be ticked.                                                                                                                                                                                                                                                                                       |

## Actions

| Action                   | Who                  | What happens                                                                                                                                                                                                                                           | API                                                                      |
| ------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| "Include phone contacts" | Anyone on the screen | Asks for the permission; once granted, the button hides and the contacts load.                                                                                                                                                                         | -                                                                        |
| Tick a person            | Same                 | Snapfix users from the user's groups can be added to this group; phone contacts can be invited.                                                                                                                                                        | -                                                                        |
| "Add a New User"         | Same                 | Opens the phone-or-email form, as in [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md). With no users left on the plan: "No new users left in this account." with a "Learn more" link to a missing help page. | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md) |
| "Invite User"            | Same                 | Opens the invitation sheet for people who aren't on Snapfix.                                                                                                                                                                                           | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md) |
| "Done"                   | Same                 | Adds the chosen Snapfix users to the group on the device and syncs ("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 contacts and the network load.
* **Empty:** "User not found in your network".
* **No permission:** "Permission Denied" and the settings dialog; the Snapfix network still works.
* **Offline (mobile):** the contacts and the network come from the phone; looking up a new person and inviting need a connection.

## Platform differences

Android only. iOS lists the phone's contacts on [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md), for every group.


---

# 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/phone-contacts.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.
