> ## Documentation Index
> Fetch the complete documentation index at: https://docs.medisync.me/llms.txt
> Use this file to discover all available pages before exploring further.
# User Registration
> Create a new healthcare-professional account
## Overview
Registers a new healthcare-professional account. New accounts are created **unverified**; a verification email is sent, and email verification is enforced at [login](/api-reference/auth/login). No authentication is required to call this endpoint, and it is not rate limited. Platform messages are returned in **German**.
## Body Parameters
First name.
Last name.
Professional email address. Validated and normalized; must be unique.
Account password. Minimum 6 characters (no complexity rules enforced).
Medical specialty.
EHR system category.
Specific EHR system name.
Medical title (Dr., Prof.). Optional.
Salutation; stored only when `Herr` or `Frau`.
Team invitation token. When valid, the new user joins the team and inherits its subscription.
## Response
Returns `201 Created` with the newly created account under `result`.
`true` when the account is created.
The created account.
Unique user id.
Medical title.
First name.
Last name.
Email address.
Medical specialty.
EHR system category.
EHR system name.
Always `false` on a new account.
## Example Request
```bash theme={null}
curl -X POST https://app.medisync.me/api/register \
-H "Content-Type: application/json" \
-d '{
"title": "Dr.",
"firstName": "John",
"lastName": "Doe",
"email": "doctor@example.com",
"password": "your_password",
"specialty": "Cardiology",
"ehr_system_type": "Epic",
"ehr_system_name": "Epic MyChart"
}'
```
## Example Response
```json 201 Created theme={null}
{
"success": true,
"result": {
"_id": "6578a1b2c3d4e5f601234567",
"title": "Dr.",
"firstName": "John",
"lastName": "Doe",
"email": "doctor@example.com",
"specialty": "Cardiology",
"ehr_system_type": "Epic",
"ehr_system_name": "Epic MyChart",
"isVerified": false
}
}
```
A new account cannot log in until its email address is verified. Registration itself still succeeds even if the verification email cannot be delivered.
## Error Responses
```json 400 Validation failed theme={null}
{
"error": "Bitte geben Sie ein Passwort mit mindestens 6 Zeichen ein."
}
```
```json 409 Email already registered theme={null}
{
"error": "Diese E-Mail-Adresse ist bereits registriert."
}
```
```json 400 Invalid team invitation token theme={null}
{
"error": "Ungültiger Einladungstoken."
}
```
```json 500 Registration failed theme={null}
{
"error": "Ein Fehler ist bei der Registrierung aufgetreten."
}
```
## Next Steps
Authenticate and obtain a JWT token.
Retrieve the authenticated user's profile.