123ContactForm API

The 123ContactForm API is built mainly for programmers who want to retrieve data from their account and, implicitly, from their forms.

Note: If you find limitations to our API, please contact us.

An API call consists of performing a cURL GET operation on the desired API page. There are also additional parameters that have to be sent through cURL POST. All parameters are presented below.

There are 2 available output formats: XML and JSON. In the case of an error, the appropriate message is displayed under an <errorMessage> tag or key.

The API base URL is:


You must use the HTTPS protocol for all the API URL’s in your script. That doesn’t mean that the URL of your script must also start with https://


The most important POST parameter is apiKey, which is required for any API call. You can find your API key in the section My AccountAccount Details of your 123ContactForm account.

The API provides the following operations:

Use the links above to find out more about each action.

Please note that a Basic user can perform up to 100 API calls per day.

Here is a PHP script example illustrating how our API can be used. And here are the API Responses you receive when using our API Key.


I am trying to understand how the API process works. I want to retrieve form submissions. We use Angular JS. (The example you have is PHP).

To retrieve forms, the documentation (http://www.123contactform.com/docs/123contactform-api-retrieve-submissions/) says, “https://123contactform.com/api/forms/{form-id-here}/submissions.{xml|json}”. Where does the API Key fit into this?

Do I have to set it a certain way (using a certain variable name) in Angular JS, before I get to the https request?

Thanks in advance for your help.

January 07, 2016 06:19
    Olivian Stoica

    Hello Srikanth!

    Would the 123ContactForm-WebHooks integration help you achieve what you are looking for? You can paste the URL of your script in the app and it will run each time a submission is made.

    Please submit a ticket at our Support Team via our contact page or send us an email at support@123contactform.com and our technicians will provide you the help you need.


    January 07, 2016 09:30
simon marshall

Hi is there or are you looking to build an api that allows for the deletion of records, we use form to front end a members database (a waiting list) it would be good to be able to delte a specific response (based upon its id ) once a member is moved from the waiting list.

October 20, 2014 04:14
    Olivian Stoica

    Hello Simon!

    From what we understand, you want to delete records based on their IDs in your database. You’ll need two scripts to do this and the WebHook integration. The first script will send the records from the form to your database. The second script will search the record based on the record’s ID and delete it once its found.

    If you have more questions or need of assistance, don’t hesitate to contact our support specialists at support@123contactform.com or via our contact form.


    October 21, 2014 06:46

joomla does not accept my API..

plz help.


July 12, 2013 02:36

Leave a Reply

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