Please note: Integration with the Nest Forms API is only available to Premium clients.
This feature allows you to access the form details from an external service, using the RESTful JSON API and the standard OAuth2 login system.
To use the oAuth feature, go to Applications, create a new application, if you don't have any.
Fill in the App name and it's endpoints. Endpoint is a URL address and needs to match exactly the redirect_url you are going to setup in your oAuth2 client configuration. You can set multiple Endpoints for one application to allow you to react to different needs of your application.
After the application is created, you can see a new tab on the Application Edit page called 'Keys'. Where you can access Client ID and Client Secret keys which are needed within your application.
The following endpoints are currently available: Authentication, Access Token, Forms list, Reports.
See more details on the API Technical Details page.
Demo Example Application - online test #
If you do not want to install this example on your test environment and would like to see your data, you can try this example application on our test environment.
You can very quickly connect to your account and see how you can use the NestForms API.
This is a great starting point for testing the NestForms API. When you would like to integrate, you will need to create an application in the nestforms.com website and we would recommend downloading the PHP Demo Example Application for more details.
Demo Example Application in PHP #
You can download our example application, which is able to authenticate with nestforms.com, refresh the tokens, if necessary, list all available forms and show the form reports.
To acquire required libraries using composer, run `composer update` in the directory with index.php and composer.json. The composer will download all required libraries for you.
In case you want to use the packed libraries, make sure the vendor directory is in the same folder as index.php.
Create an application in the nestforms.com website. You will need to set your current test application URL.
Then you only need to update the index.php with Client ID and the Client Secret that you've received in the previous step and then open the index.php in the browser.
You will be redirected to the nestforms.com website (you might be asked to login first) where you will confirm the access level rights and then you will be redirected back to the test application which will display a list of all your forms.
If you are testing on a windows machine and you recieve the following error: "ERROR: unable to fetch access token with authorization code", just edit the source code of index.php file and uncomment line 24 with $http_client_config.
The example application covers two use cases:
Working with Forms, Responses and Custom DB
This example will show you a list of all available forms. Once you click to the form, you will see all Responses. You can also list all related members. You can also list the custom DB tables within your NestForms account including the option to update the values.
This example will let you generate a special URL using the API. Then using this URL will allow you to display the NestForms website within the iframe. This might be useful for example when you want to login your client automatically within your intranet without the need for them to login.