POST/api/public/access-request/email/start-verification
Sends a six-digit confirmation code, valid for 10 minutes, to the given email address – the first step of an access request.
Send the address to be confirmed in the `email` field. The response contains `verification_id`, `expires_in_minutes` (10) and `resend_cooldown_seconds` (60). Use the `verification_id` together with the same email address and the code received in `POST /api/public/access-request/email/verify`. A new code can only be sent after the waiting time has elapsed; show the remaining time in your interface. If the limit is exceeded, the endpoint responds with 429 `RATE_LIMIT_EXCEEDED`. If the email cannot be delivered, it responds with 502 `MAIL_NOT_SENT`; check the address and try again later.
Overview
Call: POST /api/public/access-request/email/start-verification. 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: email (body). Documented error cases: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. The example response below shows the structure of a successful JSON response.
Auth & Security
No authentication required
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.
Rate Limit: 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent: No
Parameters
email(body, string, required)— Email address to be confirmedExample Request
{"email":"max@example.com"}Example Response
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Error Codes
429 RATE_LIMIT_EXCEEDED — Too many requests from this IP address. Wait before requesting a new code.502 MAIL_NOT_SENT — The confirmation code could not be delivered by email.Verified behaviour
The call returns 200 with a `verification_id`, and the code is delivered by email; repeated calls return 429 `RATE_LIMIT_EXCEEDED`.
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/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/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.