Skip to main content
POST
User Registration

Overview

Registers a new healthcare-professional account. New accounts are created unverified; a verification email is sent, and email verification is enforced at login. No authentication is required to call this endpoint. Platform messages are returned in German.

Body Parameters

string
required
First name.
string
required
Last name.
string
required
Professional email address. Validated and normalized; must be unique.
string
required
Account password. Minimum 6 characters.
string
required
Medical specialty.
string
required
EHR system category.
string
required
Specific EHR system name.
string
Medical title (Dr., Prof.). Optional.
string
Salutation; stored only when Herr or Frau.
string
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.
boolean
true when the account is created.
object
The created account.

Example Request

Example Response

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

Rate Limiting

Registration is rate limited. Exceeding the limit returns 429 with standard RateLimit-* headers and Retry-After.

Next Steps

Login

Authenticate and obtain a JWT token.

User Profile

Retrieve the authenticated user’s profile.