Get ready for a thrilling integration that's set to supercharge your Community experience! ๐
Imagine a world where you can seamlessly connect Formstack with your Community, automatically onboarding Members straight from your Formstack form submissions. It's a game changer, and here's what you need to make it happen:
This integration requires:
- API Tokens permission enabled on the account (Requested through your Account Manager)
- A valid API token
- A Formstack account
NOTE: The Formstack Integration is accessible exclusively through select usage-based plans. Kindly contact your designated Account Manager or our Customer Success Team for inquiries regarding eligibility.
ย
Setup and Activation
Community's Formstack integration securely transfers data from Formstack to Community using Formstack's webhook. Here are the steps for setting it up on a Formstack account:
ย
Form Field Setup
To ensure smooth data transfer from Formstack to Community, make sure you enter the appropriate "internal label" values for every supported fields that you include in your form (see below).ย
Community's integration requires precise values in Webhook requests from Formstack. Any discrepancies in field lables on the Formstack form can result in unrecognized data, causing unforeseen consequences.
Community hosts an example formย for customers to use as a reference here: https://community.formstack.com/forms/formstack_integration_test_form_copy.
-
Supported Fields (
internal label
)-
- Phone Number (
phone_number
) *Required - Name Field (
name
)-
- First (
first
) - Last (
last
)
- First (
-
- Email (
email
) - Address Field
-
- City (
city)
- State (
state
) - Zip (
zip
)
- City (
-
- Date Of Birth (
date_of_birth
) - Gender Identity
-
- Must be one of
male
,female
,non-binary
,no-answer
- Must be one of
-
- Phone Number (
-
Here is a sample .json payload:
{
"name": { "value": { "first": "John", "last": "Doe" } },
"phone_number": { "value": "+18185551212" },
"address": { "value": { "zip": "90210", "country": [ "US" ] } },
}
ย
Webhook Setup
After setting up the form and configuring the fields, create a Formstack Webhook to integrate with your Community account.
Prior to continuing, establish an API token for your Community account. Detailed instructions for creating an API Token can be located in your Community account under Settings > API Tokens.
ย
Step-by-Step Instructions
From the Formstack Forms interface, select the form you are trying to integrate and navigate to Settingsย (found in the upper right-hand corner).
Once in Settings, select Email & Actions from the left-hand menu, then select Add a Webhook:
ย
ย
On the Add a Webhook dialog, ensure the following settings are entered:
ย
- Webhook Name
- Enter โCommunity Formstack Integrationโ
- Webhook URL
- The URL scheme for the webhook URL is as follows:
https://api.community.com/webhooks/v1/formstack/<your_client_id>/form_submit_subscription_create?community_api_token=<token>
- Do not include the <> characters when adding your values
- A valid URL will look similar to the following:
https://api.community.com/webhooks/v1/formstack/23eebcab-e322-4b5a-824f-77702d5f88bd/form_submit_subscription_create?community_api_token=community_api_84c1121e5474aeb9a91709fdcd1c4461a422f6b2
- Remember, keep this URL secret, as the API token provides API access to your account.
- Check the following boxes:
- Post with sub-field names
- Post with field type
- Standardize field value types to be consistent
- Post Data Field Key
- Select โPost with internal field labelsโ
- Content Type
- Select โJSONโ
- File/Signature URL Type
- Select โAuthenticated URL (Default)โ
When these settings have been entered successfully, click Create Webhook to activate your integration.
To enable the community system to capture user locations accurately from the Formstack form, include a dropdown list with the specified settings.
ย
ย
With all the settings in place, exciting things happen! When your form gets a new submission with a valid phone number, your Community number will send a real-time SMS welcome message! ๐๐ฒ๐ฌ