Knowledge Base

If the default size doesn’t meet your requirements, you can easily resize the lightbox from Terms of service field.

Once your Terms of service field has been selected, in the left side panel you will find under Agreement text section different possible customizations.

The lightbox can be resized using Popup width and Popup height – just type in the size that fits your needs.

Resize Terms of service

Terms of service field

Once an Address field has been added on the form, you will notice that by default, it looks like below, containing:

  • Street address
  • Street address line 2
  • City
  • Postal/Zipcode
  • Region
  • Country → automatically filled in
Address field

Required field – under Validation section, there is an option of making the field required. Unlike the other fields, here you can select which subfields from Address are required. You can select All, some subfields or clear all your selections by clicking on None.

Required fields address field

Address format – by default, it is set as universal, but you can change it to fit United States/ Canada/Australia/United Kingdom format.

Address format

Visible subfields – by default, all subfields are visible, but if you don’t want some of them to show up, you simply have to untick them.

Visible subfields

Available countries – by default, all countries are available, but you can select the ones that you are interested in by checking them in the dropdown. You can select from 250 available countries and international entities. To uncheck them all, simply click None, on top of the dropdown list. You also have the option to check All countries back.

Available countries

Default country – by default, it is set as autodetect, this meaning that the Country subfield will automatically populate on the form depending on the respondents’ IPs. You can select one country to be the default one and it can be changed by respondents on the form if it is not applicable to them.

Default country

Region label – by default, it is set on Region, but you can change it to fit your needs. If you want to use the Region/State/County option, notice that it only changes the placeholder inside the subfield. In order to use your form on a global scale, where some form users might come from region-divided nations or states, such as the United States or Mexico, you could use Translations and write down your own placeholders, for example, “Region/State”.

Region label

Postal/Zipcode – by default, it is set on Postal/Zipcode, but you can change it to only one of the option.

postal/zipcode

PayPal has got its own order form summary. Therefore, those fields cannot be changed from your 123FormBuilder account unless the Detailed invoice option is enabled in the PayPal integration panel.

Instead, you could try PayPal Pro or PayPal PayFlow, which offers more details of the purchases made by your buyers.

If you want to style your form or make it more dynamic, you can change the label placement by deciding to either show it or hide it. This setting has to be applied to each field individually, it does not apply automatically to the entire form.

All you have to do is to select the field you are interested in bringing changes to and in the left side panel you will find the section Options. Label placement is the setting that allows you to play around with the question text.

Label placement

Shown: by default, the label placement is set on shown and looks like below:

label placement shown

Hidden: when chosen, this setting makes your question text hidden.

label placement hidden

Inside the field: when choosing this option, the question text is placed inside the field and once respondents interact with the field, the label disappears.

label placement inside the field

Removed: similar to Hidden, this option hides the label, but also the white space.

label placement removed

Your lightbox form can be triggered to pop up on the screen after a period of time of your choice. The user doesn’t need to do anything; the form will simply show up on the page in a lightbox.

In order to set up this form behavior, access your form builder account. Next, go to the PublishEmbed form section of your form. In the Auto pop-up, add the number of seconds you want to pass before the popup is triggered. Next, copy the code within the box and paste it into the code interface of your webpage.

Auto pop-up 123FormBuilder

This integration is specially provided for our Dutch users. With this application, you can integrate your 123FormBuilder web form with your Enormail mailing lists. The fields to which you can send data are Name, Email, Last Name, Gender, Company, Address, ZipcodeCity, Country, Telephone, and Mobile.

You will find the application in the Integrations section of your form. All you have to do is search for Enormail using the search bar and click on Connect.

Enormail Integration 123FormBuilder

Set as required the fields Name and Email in your Form Editor.

In Settings – Applications add Enormail and introduce the API Key of your Enormail account. You’ll find your API Key in the section Mijn account – API toegang of your Enormail account.

Enormail-123FormBuilder integration

Select a list from Use list and hit Customize.

Enormail-integration-completed

Associate Enormail fields with your 123FormBuilder fields. They are split into Mandatory fields and Optional fields. If you choose to use Gender, set the choice option with the values m and f in your Form Editor. Otherwise, it won’t appear in your Enormail account. Next press Save and you’re good to go!

customize enormail application

Now your Enormail list will retrieve contacts from your form, at each form submission. You’ll find your entries in Contacten within your Enormail account. That’s all and it’s easy as 1-2-3!

Important: Integrating complex fields, such as Address, into your form will not allow for subfields to be associated separately with your Enormail fields. Therefore we recommend you use Short text and Number fields to describe the location.

 

Important Note

This version of the API was deprecated. If you still need to automate your data collection processes, and retrieve collected data or make various operations related to your 123FormBuilder account through API calls, you can use our new and improved API v2. Please visit our developer documentation for more details.

At some point, while using our API, you may fail to access the data from your form builder account. It’s best that you understand from the very beginning the cause of these errors. Therefore, here is a complete list of all the API responses you’d receive, with explanations attached.

In XML and JSON, the API error messages appear as tags (<errorMessage>), respectively names/keys (message).

Error Messages What it means
Wrong API key This happens in three cases:
1.The API key you’ve assigned is not 35 characters (with “-”).
2.The first or the second part does not contain a numeric field.
3.The API key you’ve provided is not identical to the one from your 123FormBuilder account.
Empty API key! You haven’t assigned the API Key from your 123FormBuilder account.
You have exceeded the number of requests for today! You are not allowed to make more than 100 API calls per day on the Basic plan.
No action specified! The action cannot be found within the URL.
No form specified! The form cannot be found within the URL.
No URL specified! You haven’t specified your Webhook URL.
We couldn’t find this e-mail address associated with any of your subuser accounts! When retrieving a form, and the e-mail address is not associated with any of your subusers.
We couldn’t find this form ID in your subuser’s account! When retrieving a form, and the form ID is not associated with any of your subusers.
We couldn’t find this form ID in your account activity! The form ID you have specified in the URL cannot be found in your 123FormBuilder account.
You do not have access to this operation! The subuser is not allowed to perform this operation.
The specified webhook already exists! You cannot have duplicated webhooks.
You have more than 10 webhooks set for this form! You can have up to 10 webhooks on a form.
You can only access our API via HTTPS! You cannot access your 123FormBuilder account using HTTP.

And here is the confirmation message that you will receive when your webhook is added successfully.

Message What it means
You have successfully added a new webhook! The webhook has been added successfully.

There have been some problems reported when trying to open exported CSV files in Microsoft Excel. The submissions wouldn’t appear as tabular textual data. This is due to the fact that Excel sometimes can’t directly transform all data accordingly from the exported file. Follow the steps below on how to open a CSV file in Microsoft Excel:

1. In Excel click on New and create a Blank workbook.
2. Next, go to Data → Get External Data → From text.
3. Import the CSV file from your computer.
4. Check Delimited and, at File Origin, select 65001:Unicode (UTF-8) from the dropdown list.

Excel file origin

5. Click Next and, at Delimiters, choose the delimiter (field separator), be it space or comma. You’ll see the changes in the window below, within the wizard panel. The delimiter that you choose should be the same as the one you selected when exporting the CSV file from your 123FormBuilder account (Data Separator).

csv file separator

6. In the same panel choose the enclosure of the fields in Text qualifier. The qualifier that you choose should be the same as the one you selected when exporting the CSV file from your 123FormBuilder account. Hit Next, then Finish.

Text qualifier

7. Hit Ok and you’re done. Your submissions should now be organized within a table with well-structured columns in your Excel window.

If this doesn’t work, select New worksheet before pressing Ok, instead of leaving it on Existing worksheet. Don’t forget to save your workbook.


Related articles

PayFast is a payment processor for South Africa, therefore it will accept payments only in South African Rands.


Setting up your PayFast integration

1. Click New Form from your account dashboard and start creating your payment form.

You can use choice fields (single/multiple choice and dropdown lists) to display the products on sale or, even better, Product field.

2. In your Form Editor, in the left side panel, you will notice the Payments section. By using the search bar, you can quickly find Payfast.

Payfast

3. After adding PayFast on your form, you will notice a couple of changes: the PayFast payment processor has a tag near its name & the settings panel opens up to the right side of the page.

Payfast settings

4. In order to set up Payfast integration, you have to provide your Merchant ID and Merchant Key.

Payfast settings

If you don’t want to make a real payment, but just want to test the integration, different settings should be made in your 123FormBuilder account:

a. Enable your integration with the following information:

Merchant ID: 10000103

Merchant Key: 479f49451e829

b. Tick Use sandbox

Then, once redirected to PayFast, you need to log in under Returning buyer with the following data:

Username: sbtu01@payfast.co.za

Password: clientpass

5. Enable the payment integration by clicking on Enable button. By enabling Payfast, you will notice a couple of changes on your form.
The Payfast payment processor on the left side panel has an Enabled tag on it so you could easily scan which payment processor is enabled.

Payfast enabled

Another change is that on your form it will be displayed an Order summary. Here will appear all the products your respondents select on the form, together with the price per option, quantity and the total price. If you want to customize the order summary, all you have to do is click on it and the available settings appear on the right side panel.

Order summary

Note: You need to set the Currency to South African Rand. To do so, click on View inventory and from the second dropdown, select the appropriate currency.

Set currency

Another change is related to the Submit button. Once your payment integration is enabled, the Submit button is changed to Continue to payment. Below it, we are displaying a disclaimer together with the Payfast logo so that respondents are aware they are proceeding to a payment.

Also, the accepted cards by the Payfast integration are visually displayed so that respondents know from the start what is the accepted payment method.

You can customize the action bar (everything that is related to the submit button, additional buttons, disclaimer, etc) by simply clicking on this area.

Action bar

Under the Continue to payment button, we are displaying a disclaimer text, together with the logo & icon of the payment processor and the accepted cards. You can disable these settings by clicking on the payment processor and going to Display payment info.

Display payment info


In order to get the settings information from your PayFast account, you have to log in to your PayFast account and go to Settings. There, under Merchant identifiers, you can find your Merchant ID and Merchant Key.

123FormBuilder provides a very simple way to receive Braintree payments with your forms. You will be able to accept donations, orders, and subscription fees easy as 1-2-3.


Setting up your Braintree integration

1. Click New Form from your account dashboard and start creating your payment form.

You can use choice fields (single/multiple choice and dropdown lists) to display the products on sale or, even better, Product field.

2. In your Form Editor, in the left side panel, you will notice the Payments section. By using the search bar, you can quickly find Braintree.

Braintree

3. After adding Braintree on your form, you will notice a couple of changes: the Braintree payment processor has a tag near its name & the settings panel opens up to the right side of the page.

Braintree added on the form

4. In order to enable Braintree, you need to provide the Merchant ID, the Publich Key, Private Key and Plan ID.

The Braintree payment processor on the left side panel has an Enabled tag on it so you could easily scan which payment processor is enabled.

Braintree enabled

You may check the box for Settlement that will submit the payment for settlement in your Braintree account, although it’s only optional.

To test your 123FormBuilder – Braintree integration, you’ll need to create a sandbox account in Braintree (if you do not have one already).

Go to https://sandbox.braintreegateway.com/ to obtain a sandbox account. In 123FormBuilder, enter the credentials of your sandbox account from Braintree the same as above. Enable the sandbox on the bottom page. From now on, each payment will be submitted in sandbox mode.

5. By enabling Braintree, you will notice a couple of changes on your form.
The Braintree payment processor on the left side panel has an Enabled tag on it so you could easily scan which payment processor is enabled.

Braintree enabled

Another change is that on your form it will be displayed an Order summary. Here will appear all the products your respondents select on the form, together with the price per option, quantity and the total price. If you want to customize the order summary, all you have to do is click on it and the available settings appear on the right side panel.

Order summary

Another change is related to the Submit button. Once your payment integration is enabled, the Submit button is changed to Continue to payment. Below it, we are displaying a disclaimer together with the Braintree logo so that respondents are aware they are proceeding to a payment.

Also, the accepted cards by the Braintree integration are visually displayed so that respondents know from the start what is the accepted payment method.

You can customize the action bar (everything that is related to the submit button, additional buttons, disclaimer, etc) by simply clicking on this area.

Action bar

By clicking on the Payment processor below the form, the settings for the payment processor are opened to the right side panel. Another thing that you can customize is whether you want to show the accepted cards & the icon and logo on the form. By default, they are on.

Display payment info


In order to check your transactions in Braintree (Transaction Report), in your Braintree account, go to TransactionsTransaction Summary. After you customize the settings according to your needs, simply click on Run Transaction Summary to see your transactions.

Check transactions Braintree

In order to set up recurring payments with your Braintree integration, you will have to create a new plan. Go to Recurring BillingPlans and hit New. Next, specify the Plan Details and the Billing Details. Finally, paste the Plan ID in the SettingsPayments section of your 123FormBuilder account, under BraintreePlan ID.

Set up recurring payments Braintree

Customers who are using the Braintree payment processor to send you money will pay in the currency you have set up in your Braintree account. This setting will override the currency selected in your form’s settings. To double-check the currency go to Products and click the currency sign.

To learn how to create an online quiz you can also check out our tutorial:

Test your respondents’ knowledge using our online quiz maker.

With 123FormBuilder, you can predefine correct answers by selecting the desired field and on the right side panel you will find Quiz options.

Quiz options

Here you can select which answering option is the correct one and assign points to it.

Assign quiz points

The fields that support Quiz options are Dropdowns, Single choice fields, and Multiple choice fields. You can even use images as choices on your Online Quiz Form.

Furthermore, you can add a Countdown Timer to your form and include partial answers with or without deduction to calculate the percentage of correct answers. Upon submission, users can view their results, view the answers they’ve missed, or receive their results by email.

To enable the Countdown Timer, show missed answers and partial answers, access the forms AdvancedQuiz section.

Quiz settings

Additionally, to send the quiz results via email to your form respondents, visit the Emails section. When setting up the email notification, all you have to do is to select the Quiz template, as shown below:

Quiz email template

If you wish to Show Quiz Results, go to the Thank You section. After selecting Show Quiz Results, you can customise the message that is going to be shown to your respondents.

Thank you page quiz

Smartsheet integration allows you to send form submissions to a document. All submissions for one form will appear in the same file. You can add this application by going to Integrations and searh for Smartsheet using the search bar. Press Connect to activate the integration for your web form.

smartsheet integration

You’ll be redirected to a separate page where you’ll need to enter your Smartsheet account credentials (if not already logged in on the same browser).

smartsheet integration

In the end, click on Allow to let your two accounts communicate. When you check your Smartsheet account after submissions were made, you will see that you’ve got a new document with the name of your form showing each submission’s input on one row (the newest submission is the top row). You can locate it in the Home tab, under the Owned by me category. Open the document to see your submissions added to the content.

smartsheet integration

Note: Uploaded files through your online form will be sent as download links in a column with the name of the File Upload label. They will not be added in the Attachments column from Smartsheet. Once you have clicked the link, the download will start automatically.

Smartsheet Integration

Frequently Asked Questions

Here is a list of the most frequently asked questions. For more FAQs, please browse through the  FAQs page.

Is this service free?
Yes, we offer a free form builder service. Just sign up to the Basic plan and you are all set. This plan is forever free, but you are limited with a few features only, such as 5 forms per account, 100 submissions per month and you have to keep the backlink to 123FormBuilder on your forms. Check out our features matrix for more information.
How many forms can I create?
It depends on the service plan you are on. Higher service plans enable more features, including more web forms for your account. If you need more forms, go to the My Account section of your account and click the upgrade button. To create an unlimited number of forms, either upgrade to the Platinum service plan or higher. Consult our features matrix for more information.
How can I publish my forms?
You can publish your forms in many ways, by using their direct URL or HTML link, embedding them with a JavaScript code, Inline HTML or iFrame, using the Facebook app or the WordPress plugin, using popups, the Blogger code snippet and many more. Once you have created and customized your form, go to the Publish section to complete your work. Read more in our documentation.
How do I change my form design?
You can change the design of your form for more information. in the Themes section, which is located in your form settings. We offer a set of more than 30 predefined form themes for your forms, but you can also create your own from scratch. You can customize the submit button, the logo and more. To apply your own stylesheets, all forms come with a custom CSS editor.

Can't find what you're looking for?