FormAssembly Integration Guide

The process of integrating FormAssembly form with Link2Feed.

Instructions

This page assumes that you already have a FormAssembly form and you want to integrate with Link2Feed.

If you don't have any existing form then https://www.formassembly.com/blog/how-to-create-a-web-form/ should help you get started.

NOTE: They have to pay for their own Form Assembly subscription + the fees to Link2Feed

1. To configure the form go to Form List ➞ Configure ➞ Connectors

2. Under Form submitted click "➕Add a connector for form submission"

3. Select "HTTPS" from a popup window

4. Click "Configure"

5. Set endpoint

Set Status to "Enabled"
Set REMOTE SCRIPT URL to "https://test-intake.link2feed.com/api/form_assembly_api" for TEST site.
For LIVE site set it to "https://portal.link2feed.com/api/form_assembly_api"
Set HTTP REQUEST METHOD to "POST"

6. Mapping individual fields

Map each field that you are submitting to Link2Feed to their appropriate name from Field Mapping table below.
For example, the Last Name needs to be submitted as fa[lastName]

2. In case a field has a dropdown like Sponsoring Agency from below, make sure you map choices to correct values (agency names in this case). By default, FormAssembly adds auto-generated name which looks something like tfa_999.

3. Setting the network name and API key.

Scroll down to end of the form under "Additional values" click "➕Add another custom field"
Set field name as api_key and input your API key in the left side field. If you don't have an API key then please contact Link2Feed Support
Set field name as fa[network] and input the network name on the left side field
Click Save button

Field Mapping

Label	Link2Feed Field	FormAssembly Field Name	Possible Values

Label	Link2Feed Field	FormAssembly Field Name	Possible Values
Network Name		fa[network]	Name of the network as appears in Link2Feed
Agency Name	Name of the agency under which the client needs be created	fa[agency]	Name of the agency as appears in Link2Feed
Last Name	Last Name	fa[lastName]	Text
First Name	First Name	fa[firstName]	Text
Date of Birth	Date of Birth	fa[dob]	Date in mm-dd-yyyy format
Gender	Gender	fa[gender]	Text male, female, transgender
Ethnicity	Ethnicity	fa[ethnicity]	Text white_anglo black hispanic_latino american_indian asian aleut_or_eskimo middle_eastern_north_african not_applicable undisclosed pacific_islander other
Highest Education Level Completed	Highest Education Level Completed	fa[education]	Text grade_0_8 grade_9_11 grade_12 post_secondary_some trade_cert_professional associate_degree bachelors_degree masters_degree phd undisclosed ged
Employment Type	Employment Type	fa[employment]	Text full_time none other part_time retired student undisclosed
Self-Identifies As	Self-Identifies As	fa[selfIdentifiesAs]	Text none other person_with_disability undisclosed veteran
Social Programs	Social Programs (Monthly Income Tab)	fa[socialPrograms][]	Text afdc aid_blind_disabled chip community_program csfp headstart husky_part_a husky_part_b liheap medicaid medicare other school_meals section_8_rental snap ssdi ssi tanf veterans_aid wic
Monthly Income	Monthly Income	fa[income]	Number
Household Size	Household Members	fa[hhSize]	Number
Address Line 1	Street (Line 1)	fa[address1]	Text
Address Line 2	Street (Line 2)	fa[address2]	Text
City	City	fa[city]	Text
State	State/Province	fa[state]	Text
Zip Code	Zip Code/Postal Code	fa[zipCode]	Text
Email Address	Email Addresses	fa[emailAddress]	Text
Phone Number	Phone Numbers	fa[phoneNumber]	Text
Languages	Languages	fa[languages]	Text Language name like English, Spanish, Japanese, etc.