Formstack API (v2) Tutorial: Working with fstackapi_php library

Image Credit: https://commons.wikimedia.org/wiki/File:Apisssss.gif

In this article, we will be looking at how to work with the Formstack’s REST API v2. We will be using the fstackapi_php PHP package that I built to simplify the process.

How does Formstack’s API Work?

Formstack is an online form building platform. Formstack API is organised around objects that are involve in form creation and submission.

A user logs in to the platform, create a Form that has Fields for collecting data and share the link to the form with the target audience that can access the Form, fill in their data and make a final submission.

How to programmatically Submit a Form to Formstack

• Visit fstackapi_php repo on Github and follow the instruction to install and configure the package
• Get the id of the form you want data to be submitted to. We can do this by:
• First, getting all the forms that are available to our account and taking note of the particular form id we are interested in. It is advisable to save the returned values in a file for reference sake

//get all forms avaialable and take note of their ids
 
$fsForm = new FSForm();
 
$allForms = $fsForm->all();

• Then, let’s get the id of the fields that are associated with the form: The way Formstack works is that, each Form has associated Fields; and each Field is an object with id, name, label and other attributes. We have the formId from the snippet above. So let’s get the Fields for the form:

$fsField = new FSField();
 
$allFields = $fsField->all($formId);

It is also advisable that we save the returned ids for use later.

• Now that we have the formId, and id of the fields. Let’s construct a data and submit it to the Form via the library

Let’s assume our form has only two fields: name (id = “123433”) and email (id = “4312232”).

Note here, that the format for specifying the field is field_$fieldId. Where $fieldId is the id of a particular field. If the prefix field_ is omitted, the form submission will not reflect in Formstack’s database:

$formId = "4455455";

$data [
"field_123433" => "Demo Name",
"field_4312232" => "demo_email@gmail.com"
];

$fsSubmission = new FSSubmission();
$submission = $fsSubmission->newSubmission($formId, $data);

And that’s it — very simple right? Yeah! The fstackapi_php library makes the process seamless.

What if we want to get all the submissions? Well we only need to call this method:

$allSubmissions = $fsSubmission->all($formId);

and this method will get the detail of a single submission:

$detail = $fsSubmission->get($submissionId);

There are other methods and classes that enables you to work with folders, fields, forms and submissions. They are well documented on the Github repo of fstackapi_php.

I will encourage you to go there, read it and give it a star.

There is a chance you may not be working with Formstack API as at present. So, I will encourage you to click the heart button and recommend this to others, in your network - who might need them now.

Thanks for reading. Happy Coding!

Have you heard of PalCrib? It’s a new social media app that I am working on. If you love my writings, you’ll definitely enjoy the app. Download it now from Google PlayStore and let me know what you think