Skip to content

FormCrafts

With the FormCrafts modules in Ibexa Connect you can watch new form responses.

To get started with FormCrafts, create an account at formcrafts.com.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting FormCrafts to Ibexa Connect

To connect your FormCrafts account to Ibexa Connect you need to obtain the API key from your FormCrafts account and insert it in the Create a connection dialog in the Ibexa Connect module.

1. Log in to your FormCrafts account.

2. Click Account > Gear Symbol > API Keys.

61f26d307653e.gif

3. Copy the API Key to your clipboard.

4. Log in to your Ibexa Connect account, add a module from the FormCrafts app into an Ibexa Connect scenario.

5. Click Add next to the Connection field.

61f26d33efe1f.gif

6. In the Connection name field, enter a name for the connection.

7. In the API Key field, enter the details copied in step 3, and click Continue.

The connection has been established.

Triggers

You can watch new form responses using the following module.

Watch New Responses

Watches for new responses on the form.

Webhook Enter a name for the webhook.

See the Setting Up FormCrafts Webooks section to add webhooks to your FormCrafts account.

Actions

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://formcrafts.com/api/ For example: /v1/forms

For the list of available endpoints, refer to the FormCrafts Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Forms

The following API call returns all the tasks from your FormCrafts account:

URL: /v1/forms

Method: GET

61f26d367bf38.png

Matches of the search can be found in the module's Output under Bundle > Body > Data. In our example, 1 form was returned:

61f26d37d48d2.png

Setting Up FormCrafts Webhooks

1. Open the Watch New Responses module, enter the details as mentioned above, click Save, and copy the URL address to your clipboard. Click OK and save the trigger.

61f26d3955c19.gif

2. Log in to your FormCrafts account.

3. Click the Form in which you want to add the webhook.

61f26d3c3b367.png

4. Click the Settings > Others.

5. Click the option, Webhook: Submit Data to your Server, enter the URL address copied in step 1, and select the checkbox.

You have successfully enabled the webhook and will receive triggers when a response for the form is received.

For more information, see the FormCrafts webhook documentation.