123FormBuilder API – API Responses

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.


  1. Can I get help in this

    An error occurred while processing your request. Please contact our customer care team at customercare@123formbuilder.com to let them know you received the following error:
    Log Error ID: 2021.12.16.04_27_07_EST.dWyPN8ikwn and they will get back to you.

  2. Hi there,

    For data security reason, we would like to delete the submissions once they have been processed at our end. Is there a way to do it using an API please?



  3. Can I have a rest api integration in php with your code let me know and it should stay on the site without any redirection and return a response based on the post data to api end point look forward

    1. Hello Pavan!

      I apologize for the late reply. From what I see, your problem is linked to a 405 status code error, which can be fixed by adding a trailing slash, as explained in this article. If this is not the case, may I suggest waiting for one of my colleagues from customer support to reply to your previous email with a proper solution.

      For assistance, don’t hesitate to contact our Support Team at support@123formbuilder.com or via our contact form.


Leave a Reply

Your email address will not be published. Required fields are marked *

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?