Create a new account
const url = 'https://api.aetherpush.com/v1/auth/register';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"email":"adrian@aetherpush.com","password":"correct horse battery staple","name":"Adrian Moreno"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.aetherpush.com/v1/auth/register \ --header 'Content-Type: application/json' \ --data '{ "email": "adrian@aetherpush.com", "password": "correct horse battery staple", "name": "Adrian Moreno" }'Registers a new account with email and password. Provisions a new tenant for the account. Sends a verification email; the account cannot log in until the email is verified.
Rate limited to 5 registration attempts per IP per 60 minutes.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Plain-text password. Server-side strength validation rejects weak passwords with 400 and a structured PasswordErrorList.
Example
{ "email": "adrian@aetherpush.com", "password": "correct horse battery staple", "name": "Adrian Moreno"}Responses
Section titled “Responses”Account created. Verification email dispatched (or queued for resend if delivery failed).
object
False if the account was created but the verification email
could not be dispatched. Clients should prompt the user to
request a new verification email via /v1/auth/resend-verification.
Example
{ "message": "Account created. Please check your email to verify your account.", "accountId": "5b3f1c8a-4d2e-4a7c-9a1b-8e6f3c2d1b0a", "tenantId": "7c4a2b1d-3e5f-4b6c-8d7e-9f0a1b2c3d4e", "emailSent": true}Missing fields, a name longer than 255 characters, a value too long for a column, or a weak password.
object
Human-readable error message.
Unique identifier for the request, also exposed as the X-Request-Id response header.
Returned by registration and password-reset endpoints when the submitted password fails strength validation. Distinct from the generic Error envelope so the dashboard can render per-rule feedback inline.
object
object
object
object
Examples
Missing email or password
{ "error": "Email and password are required.", "requestId": "req_abc123"}Register name over 255 characters
{ "error": "Validation failed.", "errors": [ { "field": "name", "message": "Field is invalid" } ], "requestId": "req_abc123"}Weak password failing strength rules
{ "errors": [ { "field": "password", "message": "Password must be at least 12 characters long." }, { "field": "password", "message": "Password must contain at least one digit." } ]}An account with this email already exists.
object
Human-readable error message.
Unique identifier for the request, also exposed as the X-Request-Id response header.
Example
{ "error": "An account with this email already exists.", "requestId": "req_abc123"}Too many registration attempts from this IP.
Returned with HTTP 429 when an endpoint-specific rate limit is hit.
retryAfterSeconds indicates how long the client should wait
before retrying.
object
Example
{ "error": "Too many registration attempts. Please try again later.", "retryAfterSeconds": 3600, "requestId": "req_abc123"}Internal server error.
object
Human-readable error message.
Unique identifier for the request, also exposed as the X-Request-Id response header.
Example
{ "error": "The requested resource was not found.", "requestId": "req_abc123"}