> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# signupWithPassword

[API Reference](/api-reference/modelence/client/functions/../../../index) / [modelence](/api-reference/modelence/client/functions/../../index) / [client](/api-reference/modelence/client/functions/../index) / signupWithPassword

> **signupWithPassword**(`options`): `Promise`\<`void`>

Defined in: [packages/modelence/src/auth/client/index.ts:42](https://github.com/modelence/modelence/blob/dcea4170315a023a7e8f0c3c5d551c26b7adecf3/packages/modelence/src/auth/client/index.ts#L42)

Sign up a new user with an email and password.

## Example

```ts theme={null}
await signupWithPassword({ email: 'test@example.com', password: '12345678' });
await signupWithPassword({ email: 'test@example.com', password: '12345678', handle: 'myhandle', firstName: 'John' });
```

## Parameters

| Parameter            | Type                                                                                                                                      | Description                                                        |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `options`            | \{ `avatarUrl?`: `string`; `email`: `string`; `firstName?`: `string`; `handle?`: `string`; `lastName?`: `string`; `password`: `string`; } | -                                                                  |
| `options.avatarUrl?` | `string`                                                                                                                                  | Optional avatar URL.                                               |
| `options.email`      | `string`                                                                                                                                  | The email of the user.                                             |
| `options.firstName?` | `string`                                                                                                                                  | Optional first name.                                               |
| `options.handle?`    | `string`                                                                                                                                  | Optional custom handle. If omitted, one is derived from the email. |
| `options.lastName?`  | `string`                                                                                                                                  | Optional last name.                                                |
| `options.password`   | `string`                                                                                                                                  | The password of the user.                                          |

## Returns

`Promise`\<`void`>