> 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/account/accept-invitation.md).

# Accept invitation

{% 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: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/account/accept-invitation.md).
{% endhint %}

An invited user sets a password to join Snapfix.

* **Where:** web `/auth/set-password`, when [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md) marks the link as a `user-invitation` (`isNewUser`). iOS: `SignUpVC2`, opened by the link handler for an invitation to an account with a temporary password, when no one is signed in. Android: `InvitedUserCreateNewPasswordActivity`, opened from [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md) for a `user-invitation` link to an account with a temporary password.
* **Who:** invited users who have no password yet. A person who already has a password is signed in by [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md) and does not see this screen. The web page needs them to be signed out; a signed-in browser is sent to `/fix`.
* **Feature:** [Joining a site](https://docs.snapfix.com/product/features/onboarding/join-site.md)

Site admins send the invitations. The server checks the link before this screen opens, and marks the invitation as onboarded during that check ([Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)). The fields and the request are those of [Reset your password](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md); this is the invitation branch of the same web page.

Checked live without an invitation: the page opened with the invitation flag (`/auth/set-password?isNewUser=true`) shows this form with no first name, so the greeting uses "there". No invitation was opened or submitted \[[ASK-30](https://github.com/snapfix/docs/blob/main/ASK.md#ask-30-can-the-live-pass-reach-the-code-and-link-screens)].

![Accept invitation on the web, opened with the invitation flag and no link](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-2238f6bd1d2238bc904b0c60cdaae8eece5ba434%2Faccept-invitation.jpg?alt=media)

## Layout

### Web

1. "Hi Jane, you've been invited to join Snapfix." with the user's first name, or "Hi there, you've been invited to join Snapfix." when there is none.
2. "Set your password to get started."
3. "Password \*" and "Confirm Password \*". These two labels are written into the page as English text, not taken from the string files.
4. The rules of [Reset your password](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md#web).
5. "By signing up you agree to our" and the links "terms of service" (`https://snapfix.com/terms`) and "fair usage policy" (`https://snapfix.com/fair-use-policy`), which open in a new tab. There is no checkbox.
6. "Sign Up".
7. The help line "Having trouble loggin in? HelpHub." under the card.

There is no back arrow on this form.

### iOS

"Hi Jane, you’ve been invited to join Snapfix.", "Set your password to get started.", a password field and a confirm field, the four rules, "By signing up you agree to our" with the links "terms of service" and "fair usage policy", the link "Data Policy", the button "SIGN UP" (written in the code), and "Having trouble logging in? HelpHub.".

### Android

"Hi Jane, you've been invited to join Snapfix.", "Set your password to get started.", "Password" and "Confirm password", "Your password must include" and the four rules, "By signing up you agree to our terms of service & fair usage policy." with both as links, "Data policy", the button "Sign Up", and the help line "Having a trouble signing up?" with "HelpHub.".

## Inputs

| Field            | Type     | Required | Default | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Password         | Password | Yes      | Empty   | At least 8 characters, with a number, an uppercase and a lowercase letter. Web: "Sign Up" is disabled until the rules pass. iOS: the button is on when the field is not empty, the two match and the password has a number, as on [Reset your password](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md#inputs). Android: the button is on when the two match; the rules only change style. |
| Confirm password | Password | Yes      | Empty   | Must match. Web: "Passwords do not match" under the field.                                                                                                                                                                                                                                                                                                                                                               |

No code is asked on this screen. The verification step is commented out on iOS (`SignUpVC.swift`), and Android's invitation path does not switch it on (`LoginActivity.kt:451`).

## Actions

| Action                 | Who                        | What happens                                                                                                                                                                                                                            | API                                                                                                                                                                                 |
| ---------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Sign Up" (web)        | Invited user with the link | The same request and result as [Reset your password](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md#actions): the password with the link's user ID, context and token, then a renewed session and `/fix`. | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md), then [`POST /refresh-v2`](https://docs.snapfix.com/engineering-reference/api/auth.md) |
| "SIGN UP" (iOS)        | Invited user with the link | Checks the connection, saves the password with the link's context, renews the session and signs in, storing the password on the device. A failure shows "Something went wrong".                                                         | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md)                                                                                        |
| "Sign Up" (Android)    | Invited user with the link | Saves the password and opens the group list, or [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md).                                                                                       | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md)                                                                                        |
| Terms and policy links | Anyone                     | Web: snapfix.com in a new tab. iOS: snapfix.com pages. Android: the terms and privacy pages on `bo.snapfix.com`.                                                                                                                        | -                                                                                                                                                                                   |
| "HelpHub"              | Anyone                     | Web: saves the page's state and opens the help FAQ. iOS: the FAQ screen. Android: the login help hub.                                                                                                                                   | -                                                                                                                                                                                   |

## States

* **Loading:** the button shows its spinner while the password is saved.
* **Empty:** the button is disabled until the rules in [Inputs](#inputs) pass.
* **Error:** web: as [Reset your password](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md#states); missing link details show "Something went wrong" and send nothing. iOS: "Something went wrong". Android: the server's message.
* **No permission:** the link is the permission. On the web a signed-in browser is sent to `/fix`.
* **Offline (mobile):** iOS checks for a connection before it sends the password. Android shows its connection alert.

## Dialogs and sheets

* **Success (web, only when no refresh token is available):** an alert with "Password reset successful", the reset wording rather than an account message. Confirming it opens [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md).

## Platform differences

* **Labels.** The web's password labels are English only. iOS writes the button text in the code. Android writes "Having a trouble signing up?".
* **Terms.** All three show the terms and fair usage links; iOS and Android add a data policy link.
* **What enables the button.** The web needs all the rules; iOS needs only a number; Android needs only a match.
* **Back.** The web has no back control on this form; the reset form has one.


---

# 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/account/accept-invitation.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.
