Skip to main content
POST
/
api
/
v1
/
auth
/
signup
curl -X POST https://api.gosentrix.io/api/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePassword123!",
    "tenant_name": "My Company"
  }'

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 900,
  "user": {
    "id": "user-123",
    "email": "user@example.com",
    "email_verified": false
  },
  "tenant": {
    "id": "tenant-456",
    "name": "My Company",
    "slug": "my-company",
    "status": "pending_setup"
  }
}
Create a new user account and automatically provision a tenant. 
curl -X POST https://api.gosentrix.io/api/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "SecurePassword123!",
    "tenant_name": "My Company"
  }'

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 900,
  "user": {
    "id": "user-123",
    "email": "user@example.com",
    "email_verified": false
  },
  "tenant": {
    "id": "tenant-456",
    "name": "My Company",
    "slug": "my-company",
    "status": "pending_setup"
  }
}

​
Request Body

​
email
string
required
User email address (must be unique)
​
password
string
required
Password (min 12 characters, must include uppercase, lowercase, number, and special character)
​
tenant_name
string
required
Name for the new tenant organization

​
Response

​
access_token
string
JWT access token (valid for 15 minutes)
​
refresh_token
string
JWT refresh token (valid for 7 days)
​
expires_in
integer
Access token expiration time in seconds
​
user
object
User object with id, email, and verification status
​
tenant
object
Tenant object with id, name, slug, and status

​
Errors

​
400
object
Invalid request (duplicate email, weak password, etc.)
​
429
object
Rate limit exceeded

​
Notes

  • Email verification is required before full access
  • Tenant status will be pending_setup until onboarding is completed
  • See Verify Email for next steps