Self-Hosted APIs
Create Admin Account (Self-Hosted)
Create the first admin account for your self-hosted Databrain instance. Returns an access token for the new admin. Self-hosted only.
POST
Create the initial admin user and company for a self-hosted deployment. On success, the API returns an access token that can be used for subsequent admin operations (e.g. creating a service token, managing Data Apps). Only one company can exist on a self-hosted instance; if an account already exists, sign in via Create Admin JWT instead.
On error, the API returns a JSON object with
Headers
string
required
Must be
application/json when sending a JSON body.Request Body
string
required
Admin user’s first name. Must be between 3 and 30 characters.
string
required
Admin user’s email address. Must be a valid email with at least two domain segments (e.g.
user@example.com). Some common consumer email domains may be blocked (e.g. gmail, yahoo, outlook).string
required
Password for the admin account. Must meet:
- Minimum 8 characters
- At least 1 uppercase letter
- At least 1 lowercase letter
- At least 1 digit
- At least 1 special character
- No spaces
string
required
Name of the company/organization to create for this admin.
Response
On success, the API returns 200 with a JSON object:object
Wrapper object for the response payload.
string
JWT access token for the newly created admin. Use this in the
Authorization: Bearer <accessToken> header for admin APIs (e.g. Create Service Token, Reset Admin Password).error.code and error.message and an appropriate HTTP status (400 or 500).
Examples
HTTP Status Code Summary
Possible Errors
Related
- Create Admin JWT – Sign in and get an access token for an existing admin
- Create Service Token – Create a service token using the admin access token
- Reset Admin Password – Change password for the authenticated admin

