> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autocalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Register platform user

> Register a new platform user account

This endpoint allows white label admins to create a new user account on their platform. The new user will automatically be associated with your white label platform.

<Note>
  This endpoint requires authentication as a **white label admin**. The created user will belong to your platform.
</Note>

### Request Body

<ParamField body="name" type="string" required>
  The user's full name
</ParamField>

<ParamField body="email" type="string" required>
  The user's email address (must be unique within your platform)
</ParamField>

<ParamField body="password" type="string" required>
  The user's password (minimum 8 characters)
</ParamField>

<ParamField body="timezone" type="string">
  The user's timezone (e.g., "America/New\_York"). Defaults to "Europe/Bucharest".
</ParamField>

### Response

<ResponseField name="message" type="string">
  Success message
</ResponseField>

<ResponseField name="user" type="object">
  The newly created user's information

  <Expandable title="user properties">
    <ResponseField name="id" type="integer">
      The user's unique identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      The user's full name
    </ResponseField>

    <ResponseField name="email" type="string">
      The user's email address
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="token" type="string">
  The API token for the new platform user
</ResponseField>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "Registration successful.",
    "user": {
      "id": 123,
      "name": "John Doe",
      "email": "john@example.com"
    },
    "token": "2|abc123xyz789..."
  }
  ```

  ```json 403 Not White Label Admin theme={null}
  {
    "error": "You are not a white label admin."
  }
  ```

  ```json 422 Email Already Exists theme={null}
  {
    "message": "The email has already been taken.",
    "errors": {
      "email": ["The email has already been taken."]
    }
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The password field must be at least 8 characters.",
    "errors": {
      "password": ["The password field must be at least 8 characters."]
    }
  }
  ```
</ResponseExample>

### Example Request

```bash theme={null}
curl -X POST https://app.autocalls.ai/api/white-label/register \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "password": "securepassword123",
    "timezone": "America/New_York"
  }'
```