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

# Create account (legacy)

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

An older iOS sign-up path with three screens: a profile, a password and a verification code. The code is still compiled, but nothing in the app opens it, and its last step calls a sign-up endpoint that is switched off, so it could never create an account. This page records what the screens would do.

* **Where:** nowhere today. `CreateProfileVC` is pushed from two places, and neither is reachable:
  * `ResetPasswordVC.onPressedRegisterNow()` ([Forgot password (legacy)](https://docs.snapfix.com/how-the-apps-work/screens/account/legacy-reset.md)) pushes it, but no button in `LRF.storyboard` is connected to that action (ios @ aa31967ac8, `SnapFix/ResetPasswordVC.swift:390`).
  * The "Create your Account" button of `SmsEmailMainLoginVC` pushes it (`SmsEmailLoginSB.storyboard:700`). That screen is never shown: its only caller is commented out (`Appdelegate/AppDelegate.swift:253`), and the app signs in through `SmsEmailLoginVC` instead ([Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md)). A second copy of `SmsEmailMainLoginVC.swift` outside the build target does the same.
* **Who:** signed-out people, if it were reachable. Today people sign up by invitation or QR code ([Sign up by QR invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/qr-sign-up.md)).
* **Feature:** [Site setup in the app](https://docs.snapfix.com/product/features/onboarding/site-setup.md)

## Layout

All three screens show a step bar with three steps and blank step titles, and a back button.

1. **Profile** (`CreateProfileVC`), titled "Create your Account": a profile photo, "Onboarding code (optional - only if provided by your Account Administrator)", first name, last name, an "Email" / "Phone Number" choice with the matching field (phone with a country picker), the Google, Apple and Microsoft (Azure) buttons with the Google API policy line from [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md), "Next" and "Need help? Contact support".
2. **Password** (`SetPasswordVC`): the password field with the rules "Must be : - 8 characters minimum - contain at least one number - one uppercase letter - one lowercase letter.", the checkbox "Snapfix can send me account details and periodic product updates via email or SMS.", and "Next".
3. **Code** (`VerifyAccountVC`): "Verify your account", "A SMS text message has been send to" or "An email has been sent to" with the contact, then "Enter the six digits code from the SMS message to verify your account." (for email, the email version with a note to check the spam folder), the code field, "Resend verification code" with a 30-second countdown ("You can resend a one-time code in … seconds."), "By signing up you agree to our terms of service & fair usage policy." and "Complete Registration".

On the profile screen:

* Invitation details stored from an onboarding deep link fill the first name, last name, email and phone (`CreateProfileVC.swift:150-166`).
* When phone registration is off for the caller, only the email field shows (`CreateProfileVC.swift:175-181`). Otherwise the phone field shows first, with the device region's dialling code.
* One second after the screen opens, the app asks for notification permission if it has not asked yet.
* The single sign-on buttons and the Google line hide when the build flag `ssoDisabled` is on. It is off.

## Inputs

| Field                    | Type                         | Required                           | Default                         | Rules and messages                                                                                                                                                                                                                |
| ------------------------ | ---------------------------- | ---------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Profile photo            | Image                        | No                                 | Placeholder image               | "Choose Option" with "Camera" or "Albums", then a crop step. Sent as `profile_image` only when changed.                                                                                                                           |
| Onboarding code          | Text                         | No                                 | Empty                           | The label says it is optional.                                                                                                                                                                                                    |
| First name, last name    | Text                         | Yes                                | Empty, or the stored invitation | "Next" stays disabled until both names and the email or phone have text.                                                                                                                                                          |
| Email                    | Email                        | Yes, when "Email" is chosen        | Empty, or the stored invitation | Placeholder "Enter your email". Must be a valid email and not end in ".com.com", else "Please enter valid email address."                                                                                                         |
| Phone                    | Phone with country picker    | Yes, when "Phone Number" is chosen | The device region's code        | Placeholder "Enter your phone number". Must not be letters only and must parse for the chosen country, else "Please enter valid phone number."                                                                                    |
| Password (step 2)        | Password, with a show toggle | Yes                                | Empty                           | 8 characters or more, a number, an uppercase and a lowercase letter. Each rule in the text turns green when met; "Next" stays disabled until all pass.                                                                            |
| Product updates (step 2) | Checkbox                     | No                                 | Off                             | Sent as `account_and_product_updates`, 1 when ticked. Consent wording is open \[[ASK-27](https://github.com/snapfix/docs/blob/main/ASK.md#ask-27-where-do-users-change-their-communication-consent-and-how-should-it-be-stored)]. |
| Code (step 3)            | Digits                       | Yes                                | Empty                           | At most 6 digits. "Complete Registration" enables as soon as one digit is typed. Sent as `verification_code` with the code's reference `verification_code_uuid`.                                                                  |

## Actions

| Action                       | Who               | What happens                                                                                                                                                                                                                                                                                                             | API                                                                                                              |
| ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| "Next" (profile)             | Signed-out person | Checks that the email or phone is new. If an account exists, shows "An account exists for this email." (or "…phone number.") with "Please go to the login screen to login, or contact <customersupport@snapfix.com> for assistance." and "OK". Otherwise opens the password step.                                        | `POST /validate-username` on [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)              |
| Google, Apple, Microsoft     | Signed-out person | Starts single sign-on.                                                                                                                                                                                                                                                                                                   | [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)                                           |
| "Next" (password)            | Signed-out person | Requests a registration code and opens the code step with its reference. If the server says the contact exists, shows a custom alert: "A Snapfix account already exists for …", with the reset option that opens [Forgot password (legacy)](https://docs.snapfix.com/how-the-apps-work/screens/account/legacy-reset.md). | `POST /generate-code-mobile-bd7su-v10` on [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md) |
| "Resend verification code"   | Signed-out person | Sends a new code for the same reference and restarts the 30-second countdown.                                                                                                                                                                                                                                            | `POST /resend-code-mobile-91r7o-v10` on [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)   |
| "Complete Registration"      | Signed-out person | Sends the form and the code. authpy logs the request and returns an error without creating an account (authpy @ 5d5758661c, `app.py:1296-1310`), so the app shows "There is an issue with the data you have entered. Please try again and contact <support@snapfix.com> if the issue persists."                          | `POST /register-new-user-v9` on [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)           |
| "Need help? Contact support" | Signed-out person | Opens an email to support.                                                                                                                                                                                                                                                                                               |                                                                                                                  |

## States

* **Loading:** the shared progress overlay while a request runs; "Complete Registration" animates during the last call.
* **Empty:** not applicable.
* **Error:** an alert with the server's message, or "Something went wrong". Typed values stay.
* **No permission:** not applicable; there is no role check.
* **Offline (mobile):** the request is not sent and the shared no-connection alert shows.

## Platform differences

iOS only. Android has no equivalent screen; its sign-up is [Sign up by QR invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/qr-sign-up.md).


---

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