Skip to main content
POST
/
api
/
v3
/
user
/
register
Register new user
curl --request POST \
  --url https://app.thareja.ai/api/v3/user/register \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "password": "SecurePassword123!",
  "c_password": "SecurePassword123!",
  "team": {
    "name": "Acme Corporation",
    "description": "Leading software development company"
  },
  "timezone": "America/New_York",
  "phone": "+1-555-123-4567"
}
'
{
  "id": 1,
  "name": "John Doe",
  "email": "john.doe@example.com",
  "profile_photo_url": "https://s3.amazonaws.com/bucket/profiles/user-1.jpg",
  "current_team_id": 5,
  "token": "1|Ab3dEfGh1Jk2Lm3No4Pq5Rs6Tt7Uv8Wx9Yz0",
  "role": "owner",
  "isAdmin": "yes",
  "contact_count": 15,
  "is_first_project_added": 1,
  "is_first_task_added": 1,
  "is_first_member_invited": 1,
  "timezone": "America/New_York",
  "two_factor_confirmed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

​
Overview

Create a new user account and automatically set up their organization. After registration, a verification email is sent, and the user is automatically logged in with an authentication token.

​
Request Body

​
name
string
required
User’s full name. Also used to generate a default organization name.Example: "John Doe"
​
email
string
required
User’s email address. Must be unique in the system.Format: Valid email addressExample: "john.doe@example.com"
​
password
string
required
User’s password. Should be strong and secure.Example: "SecurePassword123!"
​
c_password
string
required
Password confirmation. Must match the password field.Example: "SecurePassword123!"
​
team
object
Optional custom organization/team details. If not provided, defaults to “[Name]‘s Organization”.
​
timezone
string
User’s timezone.Example: "America/New_York"
​
phone
string
User’s phone number.Example: "+1-555-123-4567"

​
Response

The response is identical to the login endpoint, containing user details and authentication token.
​
id
integer
User’s unique identifier.
​
name
string
User’s full name.
​
email
string
User’s email address.
​
username
string
Automatically generated unique username.
​
profile_photo_url
string
URL to user’s profile picture (default avatar).
​
current_team_id
integer
ID of the newly created organization/team.
​
token
string
Authentication token for API requests. Use this in the Authorization: Bearer {token} header.
​
role
string
User’s role (always "owner" for new registrations).
​
isAdmin
string
Admin status (always "yes" for new registrations).
​
contact_count
integer
Number of contacts (0 for new users).
​
is_first_project_added
integer
Onboarding flag: Whether the first project has been added (0 for new users).
​
is_first_task_added
integer
Onboarding flag: Whether the first task has been added (0 for new users).
​
is_first_member_invited
integer
Onboarding flag: Whether the first team member has been invited (0 for new users).
​
checkapp
string
App identifier (set to “tracker”).
​
maxSpeedLimit
integer
Maximum speed limit setting (80).
​
email_verified_at
string
Email verification timestamp (null until verified).
​
created_at
string
Timestamp when the user account was created.
​
updated_at
string
Timestamp when the user account was last updated.

​
Example Request - Basic Registration

Body

application/json
​
name
string
required

User's full name

Example:

"John Doe"

​
email
string<email>
required

User's email address (must be unique)

Example:

"john.doe@example.com"

​
password
string<password>
required

User's password

Example:

"SecurePassword123!"

​
c_password
string<password>
required

Password confirmation (must match password)

Example:

"SecurePassword123!"

​
team
object

Optional custom organization details

​
timezone
string

User's timezone

Example:

"America/New_York"

​
phone
string

User's phone number

Example:

"+1-555-123-4567"

Response

Registration successful

​
id
integer
Example:

1

​
name
string
Example:

"John Doe"

​
email
string<email>
Example:

"john.doe@example.com"

​
profile_photo_url
string<uri>
Example:

"https://s3.amazonaws.com/bucket/profiles/user-1.jpg"

​
current_team_id
integer
Example:

5

​
token
string

Bearer token for API authentication

Example:

"1|Ab3dEfGh1Jk2Lm3No4Pq5Rs6Tt7Uv8Wx9Yz0"

​
role
enum<string>
Available options:
owner,
manager,
member,
client
Example:

"owner"

​
isAdmin
enum<string>
Available options:
yes,
no
Example:

"yes"

​
contact_count
integer
Example:

15

​
is_first_project_added
enum<integer>

0 = not added, 1 = added

Available options:
0,
1
Example:

1

​
is_first_task_added
enum<integer>

0 = not added, 1 = added

Available options:
0,
1
Example:

1

​
is_first_member_invited
enum<integer>

0 = not invited, 1 = invited

Available options:
0,
1
Example:

1

​
timezone
string
Example:

"America/New_York"

​
two_factor_confirmed_at
string<date-time> | null
​
created_at
string<date-time>
​
updated_at
string<date-time>