> For the complete documentation index, see [llms.txt](https://docs.digit.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digit.org/complaints-management/access/account-creation-and-onboarding-guide/create-account.md).

# Create Account

## Overview

Creating your account involves three stages, shown at the top of the screen: Account, Preferences and Review. Before you start, validate your email address.

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FbcUFbJXKSg4YQzBFHB1P%2Funknown.png?alt=media&amp;token=49d68eab-065f-4193-89fe-63e253d3efc4" alt="" height="323" width="624"></div>

{% hint style="info" %}
**Note:** There is no password to create during sign-up. Instead, we email you a secure sign-in link.&#x20;
{% endhint %}

## Steps

### Step 1: Verify your email

1. Open the sign-up page. You will see "Verify your email to begin".
2. Enter your First name and Last name.
3. Enter your Email address. Use a work address you check regularly; it is how you will sign in from now on.
4. Select Email me a sign-in link. The button only becomes clickable once all three boxes are filled in.
5. If the email provided is wrong, select Use a different email and enter it again on the next page.

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FnWRV9oBrS6Kl2vDurJz0%2Funknown.png?alt=media&amp;token=367e7fe7-e6a4-4c97-9389-7e2797e184f9" alt="" height="436" width="624"></div>

### Step 2: Open the sign-in link

1. Open your email inbox and look for a new message with a sign-in link.
2. This link redirects you back into the Complaint Management System
3. You are now signed in, and the sign-up page shows your email with a green Verified badge.

{% hint style="info" %}
**Important:** The sign-in link works only once and expires after 30 minutes.

You can ask for up to 3 links every 30 minutes. Wait 30 minutes, then try again if you want a new email.

**Do not forward this email. Anyone with the link can sign in as you.**
{% endhint %}

### Step 3: Account details

You will see "Set up your account".

1. Account name: type your organisation's name. Example: a county government, an agency, a department or a programme.
2. Account code: this is auto-filled for you from the Account name, for example KE-BOMET-COUNTY-GOVERNMENT. You can change it.
3. Select Continue.

<table><thead><tr><th width="156.39453125">Field</th><th>Note</th></tr></thead><tbody><tr><td>Account name</td><td>Required.<br><br>This will be the name of your system displayed for citizens and employees.</td></tr><tr><td>Account code</td><td>2 to 32 characters. Capital letters A to Z, numbers 0 to 9 and hyphens (-) only. No spaces. Must not already be used.<br><br>This is the unique ID used by the system to identify your account.</td></tr></tbody></table>

{% hint style="info" %}
**Important:** Choose your account name and code with care. The code identifies your organisation everywhere in the system.
{% endhint %}

### Step 4: Preferences

You will see "Personalise your account". All boxes are required.

1. Base country of operations: select your country. Example: Kenya. This fills in a suggested time zone and the correct mobile number format.
2. Languages: English is already selected. Select any others your citizens and staff use, such as Swahili.
3. Timezone: check the suggestion. For Kenya, it is Africa/Nairobi.
4. Financial year: select the one your organisation uses.&#x20;
5. Account URL: this is filled in from your account name. Keep it short and easy to recognise.
6. Your mobile number: the country code (for Kenya, +254) is already shown, so type only the rest of the number.
7. Select Continue.&#x20;

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FY8mkMKPYGhje55QdH7OA%2Funknown.png?alt=media&amp;token=00a0a4a2-5e7e-453c-96d1-e90a75875668" alt="" height="356" width="624"></div>

<table><thead><tr><th width="167.6015625">Field</th><th>Rules</th></tr></thead><tbody><tr><td>Account URL</td><td>2 to 63 characters. Lowercase letters, numbers and hyphens only. Must start with a letter or number and include at least two letters. Cannot be a reserved word such as "api", "citizen" or "employee". Must not already be used.</td></tr><tr><td>Mobile number </td><td><p>Kenya: 9 digits starting with 7 or 1</p><p>India: 10 digits starting with 6 to 9. </p><p>Ethiopia: 9 digits starting with 9. Mozambique: 9 digits starting with 82 to 87.</p></td></tr></tbody></table>

### Step 5: Review and create

1. You will see "Review and create your account" with a summary of everything you entered.
2. Check every line carefully. To change something, select Back.
3. Tick I agree to the terms of service.
4. Select Create account.

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2FWFG8pqXjM37Ln2bLez8d%2Funknown.png?alt=media&amp;token=27dc453a-ef31-4f47-84c5-069bbaf7ffd3" alt="" height="353" width="624"></div>

### Step 6: Wait while your account is set up

You will see "Setting up" followed by your account name. This usually takes a minute or two. Keep the page open. The screen ticks off each step as it finishes:

* Creating your workspace
* Setting up the basics
* Creating your employee record
* Setting up your account
* Adding you to your account
* Connecting your sign-in

When it is done, you are taken straight to the setup Home page. If it takes longer than 2 minutes, the page says "Your workspace is almost ready" and continues on its own. You can also sign in again a little later.

<div align="left"><img src="https://2002286464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK894BCuKVRy7QDBs06em%2Fuploads%2Fu9YYcLoc9cnMmaYwEqb1%2Funknown.png?alt=media&amp;token=a090b5ca-afb4-4071-a24d-400a2864d80b" alt="" height="355" width="624"></div>

{% hint style="info" %}
**Note:** Whoever creates the account automatically becomes its account admin and is added as the first employee.
{% endhint %}

### If something goes wrong

<table><thead><tr><th width="324.93359375">What you see</th><th>What to do</th></tr></thead><tbody><tr><td>That sign-in attempt expired or was already used.</td><td>Go back to the sign-up page and ask for a new link.</td></tr><tr><td>Your sign-in expired. Sign in again to pick up where you left off.</td><td>Sign in again. Your details are saved.</td></tr><tr><td>Already taken (account code)</td><td>Change the code, for example by adding a short word.</td></tr><tr><td>That account URL is already taken.</td><td>Choose a different account URL.</td></tr><tr><td>That isn't a valid mobile number in Kenya.</td><td>Type 9 digits starting with 7 or 1. Check the mobile phone rules for each country.</td></tr><tr><td>Your user account couldn't be created with the details you gave.</td><td>Select Change my details, correct your mobile number, and try again.</td></tr><tr><td>Setup hit a problem that's usually temporary.</td><td>Select Try again.</td></tr><tr><td>This signup cannot be retried. Please contact support.</td><td>Contact your support team and quote the reference shown on screen.</td></tr><tr><td>Your details were changed in another tab or window.</td><td>Reload the page and carry on.</td></tr><tr><td>Couldn't reach the server.</td><td>Check your internet connection and try again.</td></tr></tbody></table>


---

# 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.digit.org/complaints-management/access/account-creation-and-onboarding-guide/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.
