POST/api/public/access-request

Submits an access request for a package (Starter, Individuell or 14-day demo). A previously confirmed email address is required.

First confirm the email address via `POST /api/public/access-request/email/start-verification` and `POST /api/public/access-request/email/verify`. Then send `name`, the same `email`, the package `package` (`starter`, `individual` or `demo_access`) and the `verification_token` received. Optional fields are `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` or `stripe_sepa`), `wish` (`trial`, `subscription` or `offer`; always `trial` for demo access) and `message`. Without a valid confirmation, the server responds with 400 `EMAIL_NOT_VERIFIED`. Missing required fields or invalid values for package, payment method or wish result in 400 `VALIDATION_ERROR`. Every successful request is created as a new request and processed by Zentor, so 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/access-request. 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), package (body). Optional parameters: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Documented error cases: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— Email address previously confirmed via `/email/verify`
package(body, string, required)— Package: `starter`, `individual` or `demo_access`
company(body, string)— Company, max. 160 characters (optional)
phone(body, string)— Phone number, max. 40 characters (optional)
companyWebsite(body, string)— Company website, max. 200 characters (optional)
paymentMethod(body, string)— Payment method: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` or `stripe_sepa` (optional)
wish(body, string)— Wish: `trial`, `subscription` or `offer`; always `trial` for `demo_access` (optional)
message(body, string)— Message, max. 3000 characters (optional)

Example Request

{"name":"John Doe","email":"max@example.com","package":"demo_access"}

Example Response

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Error Codes

400 VALIDATION_ERROR — A required field is missing, or the package, payment method or wish is invalid.
400 EMAIL_NOT_VERIFIED — The email address was not previously confirmed via `/email/start-verification` and `/email/verify`, or the `verification_token` is missing or invalid.

Verified behaviour

An empty body returns 400 `VALIDATION_ERROR`; valid data without a confirmed email address returns 400 `EMAIL_NOT_VERIFIED`. The success case follows the documented flow after email confirmation.

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-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