# Create User

Create a new user account.

## Request Body

**`email`** string required

Valid email address.

**`password`** string required

User password (minimum 8 characters).

**`first_name`** string optional

User's first name.

**`last_name`** string optional

User's last name.

## Returns

Returns the created User object with a 201 status code.

Request

```bash
curl -X POST \
  "https://api.aitronos.com/v1/user" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "password": "SecurePassword123!",
    "first_name": "Jane",
    "last_name": "Smith"
  }'
```


```python
import requests

response = requests.post(
    "https://api.aitronos.com/v1/user",
    json={
        "email": "newuser@example.com",
        "password": "SecurePassword123!",
        "first_name": "Jane",
        "last_name": "Smith"
    }
)
```


```javascript
const response = await fetch('https://api.aitronos.com/v1/user', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'newuser@example.com',
    password: 'SecurePassword123!',
    first_name: 'Jane',
    last_name: 'Smith'
  })
});
```

**Response:**

201 Created

```json
{
  "id": "usr_xyz789",
  "email": "newuser@example.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "is_active": true,
  "last_verified": null,
  "global_role_id": null,
  "created_at": "2025-11-19T14:30:00Z",
  "updated_at": "2025-11-19T14:30:00Z"
}
```

409 Conflict

```json
{
  "success": false,
  "error": {
    "code": "USER_ALREADY_EXISTS",
    "message": "An account with this email already exists.",
    "status": 409
  }
}
```

422 Validation Error

```json
{
  "success": false,
  "error": {
    "code": "INVALID_EMAIL_FORMAT",
    "message": "The email address format is invalid.",
    "status": 422
  }
}
```