With the “Form Endpoint” event element, you can create forms outside of Quentn and transfer the submitted data directly to Quentn.
This is especially useful in combination with AI: You define in Quentn which data your form should collect and then receive all the technical information an AI needs to create a fully functional form.
For example, you can provide the AI with the prepared code from Quentn and ask:
“Create a landing page with a suitable form.”
The AI creates the page together with the form. When someone fills out and submits the form, the data is transferred directly to Quentn via the form endpoint, and the contact can enter your campaign at this point.
Set up the Form Endpoint
Drag the “Form Endpoint” event element into your campaign and open it.
Inside the element, you will find an individual endpoint URL. The form data will later be sent to this address.
Before you can use the endpoint, you first define which data the form should collect.
1. Select fields
First, select the contact fields that should be used in your form and then transferred to Quentn.
These can include, for example:
- First name
- Last name
- Email address
- Phone number
- Company
- Custom contact fields
The selected fields will form the basis of your form.
2. Define required fields
For each selected field, you can specify whether it should be a required field.
If you activate the corresponding option, this field must be completed before the form can be submitted successfully.
The email address is always required and therefore cannot be used as an optional field.
3. Configure Flood Protection and spam protection
As with forms created directly in Quentn, you can also protect the form endpoint against automated or unusually frequent requests.
The familiar options for Flood Protection and spam protection are available for this purpose.
We recommend enabling these protection mechanisms, especially if your form is publicly accessible on a website.
4. Create an example
Once you have defined your fields and settings, click “Integration Guide”.
Quentn will now generate various examples and definitions that you can either use yourself for the technical implementation or pass directly to an AI.
Examples for the endpoint
JSON
Under “JSON”, you will find an example of how the data can be transferred to the endpoint when the form is submitted.
The example contains the fields you selected and shows the expected structure of the request.
This option is particularly relevant when the data is transmitted using the Content-Type application/json.
Form Encoded
Under “Form Encoded”, you will find the same information in a different transmission format.
Here too, you can see which fields are transmitted to the form endpoint. The only difference is how the data is transmitted technically.
Which option you need depends on how the form or application is implemented.
How to build the form
In this section, you will find all the information required to turn your form endpoint into a fully functional form.
HTML
Under “HTML”, Quentn provides a complete example code for a form.
This code already contains the required functionality:
- the selected form fields
- the connection to the form endpoint
- submitting the data
- processing the response
The example deliberately does not include extensive styling. It is primarily intended as a technical template.
You can then style the code yourself or provide it to an AI and say, for example:
“Style this form to match my website.”
Field Definition
Under “Field Definition”, you will find a detailed technical description of the form.
Among other things, it defines:
- which fields are available,
- which fields are required,
- which values are expected,
- how the data must be structured, and
- where the data must be sent.
The description is provided as a JSON schema and is suitable, for example, for developers or applications that need to generate a form based on a structured definition.
Create a form with AI
The particularly useful section can be found under “AI Prompt Template”.
Here, Quentn compiles all relevant information so that you can copy it directly into an AI assistant.
This means you do not need to explain to the AI which fields are available, which of them are required or which endpoint the data should be sent to. This information is already included.
Simply copy the entire content from “AI Prompt Template” and paste it into your AI assistant.
You can then add instructions such as:
“Based on this information, create a modern landing page with a form. The page should be in German and display a confirmation after the form has been submitted.”
Or:
“Create a form that matches my existing website. Use the following colours and optimise the design for smartphones.”
This allows you to create individual forms, landing pages or even interactive applications with just a few instructions, without having to program the connection to Quentn yourself.
What happens after submission?
As soon as a visitor submits the form, the data is sent to the individual endpoint URL of the event element.
Quentn checks the submitted data and assigns it to the corresponding contact.
The contact then triggers the “Form Endpoint” event and continues through your campaign from this point.
This allows you to connect websites, AI-generated landing pages, calculators, quizzes or other external applications directly to your Quentn campaigns.