POST/api/public/consultation

Accepts a consultation request from the form on the Zentor App website.

Required fields are `name` (2–120 characters), `email` (valid email address) and `consentGiven`, which must be set to `true`. Optionally, `company`, `phone` and `message` can be sent. On success, the server responds with `{"ok":true}` and a confirmation message; the Zentor team then gets in touch. If a required field is missing or invalid, or consent is missing, the endpoint responds with 400 `VALIDATION_ERROR`. Every successful call creates a new request, so the call is not idempotent. 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/consultation. 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), consentGiven (body). Optional parameters: company (body), message (body), phone (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 characters
email(body, string, required)— Valid email address
company(body, string)— Company (optional)
message(body, string)— Message (optional)
phone(body, string)— Phone number (optional)
consentGiven(body, boolean, required)— Privacy consent, must be `true`

Example Request

{"name":"John Doe","email":"max@example.com","company":"Example Company Ltd.","message":"Inquiry","consentGiven":true}

Example Response

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Error Codes

400 VALIDATION_ERROR — A required field is missing or invalid, or consent is missing.

Verified behaviour

Complete data returns 200; missing or invalid data returns 400 `VALIDATION_ERROR`.

Public Forms

POST /api/public/contactAccepts a request from the contact form on the Zentor App website and forwards it to the Zentor team.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.

Related articles

← Public Forms