Company logoTrust Center Documentation

Create user account

Creates a new user account and associated tenant in the system. Supports multiple authentication providers including email/password and OAuth. Includes advanced security features like CAPTCHA verification and risk assessment.

For OAuth providers (GitHub, Google), returns a redirect URL. For email/password signup, creates the tenant and returns a session ID.

POST
/api/v1/signup
company_namestring

Company or organization name

Length2 <= length
first_namestring

User's first name

Length1 <= length
last_name?string

User's last name (optional)

title?string

User's job title (optional)

providerstring

Authentication provider to use

Default"default"
Value in"default" | "github" | "google"
email?string

Email address (required for default provider)

Formatemail
password?string

Password (required for default provider)

Formatpassword
Length8 <= length
legal_consent?boolean

Acceptance of terms of service (required for default provider)

altcha_payload?string

CAPTCHA verification payload (optional but recommended)

user_timezone?string

User's timezone for verification (optional)

Response Body

const body = JSON.stringify({
  "company_name": "Acme Corporation",
  "first_name": "John",
  "provider": "default"
})

fetch("https://app.orbiqhq.com/api/v1/signup", {
  body
})

{
  "success": true,
  "sessionId": "session_abc123",
  "redirectUrl": "/api/v1/admin/tenants/progress?session=session_abc123"
}

{
  "errors": [
    {
      "field": "email",
      "message": "Valid email required"
    },
    {
      "field": "password",
      "message": "Password must be at least 8 characters"
    }
  ]
}

{
  "errors": [
    {
      "field": "company_name",
      "message": "A company with this name already exists"
    }
  ]
}

{
  "errors": [
    {
      "field": "form",
      "message": "An unexpected error occurred. Please try again."
    }
  ]
}

How is this guide?