POST/api/public/access-request/email/verify

Checks the code delivered by email and issues a confirmation token for the subsequent access request.

Send `verification_id` (from `start-verification`), the same `email` and the six-digit `code`. On success, the response contains `verified: true` and a `verification_token`, which you include when submitting the access request via `POST /api/public/access-request`. An incorrect or expired code, a non-matching `verification_id` or a different email address results in 400 `VERIFY_FAILED`. In this case, request a new code. The token is valid only for this email address and must not appear in URLs or logs. At most 10 requests per 15 minutes per IP address.

Overview

Call: POST /api/public/access-request/email/verify. 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: verification_id (body), email (body), code (body). Documented error cases: 400 VERIFY_FAILED. The example response below shows the structure of a successful JSON response.

Auth & Security

No authentication required

Idempotent: No

Parameters

verification_id(body, string, required)— `verification_id` from `start-verification`
email(body, string, required)— The same email address used to request the code
code(body, string, required)— Six-digit code from the email

Example Request

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

Example Response

{"ok":true,"verified":true,"verification_token":"<token for the subsequent access request>"}

Error Codes

400 VERIFY_FAILED — The code, `verification_id` or email address is incorrect, or the code has expired.

Verified behaviour

An incorrect code returns 400 `VERIFY_FAILED`. The success case corresponds to the email confirmation of the product configurator.

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/start-verificationSends a six-digit confirmation code, valid for 10 minutes, to the given email address – the first step of an 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