Docs
Skip to content
post

Create Account

Endpoint

posthttps://<REGION>.cloud.appwrite.io/v1/account

Description

Use this endpoint to allow a new user to register a new account in your project. After the user registration completes successfully, you can use the /account/verfication route to start verifying the user email address. To allow the new user to login to their new account, you need to create a new account session.

Required scopes

public

Authentication

Initialize the Appwrite client with setProject(). No signed-in user or server API key is required.

Rate limit

Up to 10 requests per hour for each IP address calling this endpoint.
Server API key requests bypass this rate limit.

Parameters

string
Required

Unique Id. Choose a custom ID or generate a random ID with ID.unique(). Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.

string
Required

User email.

string
Required

User password. Must be at least 8 chars.

string

User name. Max length: 128 chars.

Status
Content type
201
application/json

Account

Name
Type
Description
string

User ID.

string

User creation date in ISO 8601 format.

string

User update date in ISO 8601 format.

string

User name.

string

User registration date in ISO 8601 format.

boolean

User status. Pass true for enabled and false for disabled.

string

Password update time in ISO 8601 format.

string

User email address.

string

User phone number in E.164 format.

boolean

Email verification status.

boolean

Phone verification status.

object

User preferences as a key-value object Can be one of: preferences

JavaScript
import { Client, Account } from "appwrite";


const client = new Client();


const account = new Account(client);


client
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('5df5acd0d48c2') // Your project ID
;


const promise = account.create('[USER_ID]', 'email@example.com', 'password');


promise.then(function (response) {
    console.log(response); // Success
}, function (error) {
    console.log(error); // Failure
});