POST/api/public/contact
Accepts a request from the contact form on the Zentor App website and forwards it to the Zentor team.
Required fields are `name` (2–120 characters), `email` (valid email address), `message` (10–3000 characters) and `consentGiven`, which must be set to `true`. Optionally, `company`, `phone` and `topic` can be sent. On success, the server responds with `{"ok":true}` and a confirmation message. If a required field is missing or invalid, or consent is missing, the endpoint responds with 400 `VALIDATION_ERROR`; the `details` field lists the individual errors so that you can highlight the affected input fields. Every successful submission creates a new request. Therefore, disable the submit button until the response arrives and do not retry the call automatically. At most 10 requests per 15 minutes per IP address. Zentor's access rules (IP, country and email domain rules) also apply; rejected calls receive 403.
Overview
Call: POST /api/public/contact. This endpoint belongs to the “Public Forms” group of the Zentor App API. It is publicly accessible and requires no authentication. The call is not idempotent: every successful call triggers the action again. Required parameters: name (body), email (body), message (body), consentGiven (body). Optional parameters: company (body), phone (body), topic (body). Documented error cases: 400 VALIDATION_ERROR. The example response below shows the structure of a successful JSON response.
Auth & Security
No authentication required
Idempotent: No
Parameters
name(body, string, required)— Name, 2–120 charactersemail(body, string, required)— Valid email addressmessage(body, string, required)— Message, 10–3000 characterscompany(body, string)— Company (optional)phone(body, string)— Phone number (optional)topic(body, string)— Topic of the request (optional)consentGiven(body, boolean, required)— Privacy consent, must be `true`Example Request
{"name":"John Doe","email":"max@example.com","message":"Your message (min. 10 characters).","consentGiven":true}Example Response
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Error Codes
400 VALIDATION_ERROR — A required field is missing or invalid, or privacy consent is missing. `details` contains the individual error messages.Verified behaviour
Complete data returns 200; missing required fields or missing consent return 400 `VALIDATION_ERROR`.
Public Forms
POST /api/public/consultationAccepts a consultation request from the form on the Zentor App website.POST /api/public/access-requestSubmits an access request for a package (Starter, Individuell or 14-day demo). A previously confirmed email address is required.POST /api/public/access-request/email/start-verificationSends a six-digit confirmation code, valid for 10 minutes, to the given email address – the first step of an access request.POST /api/public/access-request/email/verifyChecks the code delivered by email and issues a confirmation token for the subsequent access request.GET /api/public/access-request/payment-statusIndicates which payment methods (PayPal, Stripe) are currently available for the access request.GET /api/public/access-request/paypal/configReturns the public PayPal configuration (enabled, mode, currency) for the payment step.POST /api/public/access-request/paypal/create-orderCreates a PayPal order for the selected package.POST /api/public/access-request/paypal/capture-orderCompletes (captures) a previously created order that the buyer has approved in the PayPal checkout. The amount is set by the server alone.POST /api/public/access-request/stripe/create-checkoutCreates a Stripe checkout session for the selected package.POST /api/public/activate-accountActivates a newly created user account and sets the first password – triggered via the link in the invitation email.