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 your own unique ID or pass the string ID.unique() to auto generate it. 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

Java
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
import io.appwrite.Client
import io.appwrite.services.Account


public class MainActivity extends AppCompatActivity {


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);


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


        Account account = new Account(client);


        account.create(
            "[USER_ID]", 
            "email@example.com", 
            "password", 
            new Continuation<Object>() {
                @NotNull
                @Override
                public CoroutineContext getContext() {
                    return EmptyCoroutineContext.INSTANCE;
                }


                @Override
                public void resumeWith(@NotNull Object o) {
                    String json = "";
                    try {
                        if (o instanceof Result.Failure) {
                            Result.Failure failure = (Result.Failure) o;
                            throw failure.exception;
                        } else {
                            Response response = (Response) o;
                            json = response.body().string();
                        }                    
                    } catch (Throwable th) {
                        Log.e("ERROR", th.toString());
                    }
                }
            }
        );
    }
}