Form Webhook Integration and Field Mapping
Momentum AMS supports form webhook integrations that allow agencies to receive quote application information submitted through websites and third-party form builders.
By connecting your form to Momentum AMS and mapping the submitted fields, you can reduce manual data entry and streamline how incoming Quote Applications are processed.
- A prospect or customer completes a form on your website.
- The form sends the submitted information to Momentum AMS through a webhook.
- The submission appears under Prospects/Leads > Quote Applications.
- You map the submitted form fields to the appropriate Momentum AMS fields.
- Momentum AMS remembers the mapping for future submissions using the same Form Name.
Part 1: Setting Up the Form Webhook Integration
Step 1: Locate Your Agency ID
Your Agency ID identifies the Momentum AMS agency that should receive the submitted information.
- Log in to Momentum AMS.
- Navigate to your Agency Profile.
- Review the URL displayed in your browser's address bar.
- Locate the Agency ID between Details/ and /Information.
- Copy the Agency ID for use in your form configuration.
Example URL:
https://www8.nowcerts.com/AMSINS/Agencies/Details/[AGENCY_ID]/InformationThe value represented by [AGENCY_ID] is the identifier you will use when configuring your form.
Make sure you copy the Agency ID from the agency that should receive the Quote Applications. An incorrect Agency ID may prevent submissions from being associated with the intended agency.
Step 2: Create Your Website Form
Create your form using a compatible website form builder or third-party form platform.
Examples of form builders include:
- Gravity Forms
- Typeform
- Jotform
- Other form platforms that support JSON webhook submissions using POST requests
Recommended Form Fields
Include the information your agency needs to begin processing a quote application.
- Applicant Name
- Email Address
- Phone Number
- Coverage Type
- Additional information relevant to the requested quote
Required Hidden Fields
Your form must also include the following fields:
| Field | Purpose |
|---|---|
| AgencyID | Identifies the Momentum AMS agency receiving the submission. Enter the Agency ID obtained in Step 1. |
| Form Name | Identifies the form and allows Momentum AMS to recognize previously saved field mappings for future submissions. |
For example, you might use Auto Insurance Quote Application as the Form Name.
Momentum AMS uses the Form Name to identify the mapping associated with a submission. Use a descriptive name and keep it consistent so future submissions can use the saved field mapping.
Step 3: Configure the Webhook URL
In your form builder, configure the webhook to send the submitted information to Momentum AMS.
Request Method: POST
Data Format: JSON
Webhook Endpoint:
https://api.nowcerts.com/api/PushJsonQuoteApplicationsMake sure your form platform is configured to submit the form data to this endpoint.
Your form platform must support POST webhook requests using JSON. Confirm that the required AgencyID and Form Name values are included in the submitted information.
Step 4: Submit a Test Quote Application
Before using the form with actual customers, submit a test application to confirm the webhook is working.
- Open the form on your website or within your form builder.
- Complete the fields using sample information.
- Submit the form.
- Log in to Momentum AMS.
- Navigate to Prospects/Leads > Quote Applications.
- Confirm that the test submission appears in the list.
If your test submission appears under Quote Applications, the webhook has successfully delivered the application to Momentum AMS. The next step is to configure field mapping.
Part 2: Mapping Form Fields in Momentum AMS
After the initial submission has been received, you need to map the form fields to the corresponding fields within Momentum AMS.
This tells the system where the submitted information should be placed when the Quote Application is processed.
Step 1: Open the Received Quote Application
- Navigate to Prospects/Leads > Quote Applications.
- Locate the test submission.
- Click Edit to open the application.
Step 2: Understand the Field Mapping Layout
The Quote Application mapping screen displays the submitted information and provides options for assigning the data to Momentum AMS fields.
| Column | Description |
|---|---|
| Left Column | Displays the field labels from your submitted form, such as Applicant Name. |
| Middle Column | Displays the submitted values, such as the applicant's name or phone number. |
| Right Column | Provides the Map option for assigning the submitted information to a Momentum AMS field. |
Step 3: Map the Submitted Fields
For each field included in the form:
- Locate the submitted field and its corresponding value.
- Click Map.
- Select the appropriate Momentum AMS field.
- Repeat this process for the remaining fields.
Example: A form field labeled Applicant Name may be mapped to the corresponding Insured Name field in Momentum AMS.
Incorrect field mapping can cause submitted information to populate in the wrong place. Verify each field assignment before saving and merging the application.
Step 4: Save and Merge the Application
After mapping the fields, click Save and Merge.
This action:
- Processes the submitted information into Momentum AMS.
- Saves the field mapping for future submissions using the same Form Name.
Once the initial mapping has been saved, future submissions using the same Form Name can reuse the existing field assignments.
Part 3: Processing Future Form Submissions
How Saved Field Mapping Works
Momentum AMS remembers the mapping associated with the Form Name.
When additional applications are submitted using the same Form Name, the previously saved mapping is applied.
This eliminates the need to manually map the same fields each time a new application is received.
Review and Process New Applications
When a new form submission is received:
- Navigate to Prospects/Leads > Quote Applications.
- Open the new submission.
- Review the submitted information for accuracy.
- Confirm the field mapping is appropriate.
- Click Save and Merge to process the application.
Saved mapping allows Momentum AMS to remember where form fields belong. New Quote Applications should still be reviewed and processed using Save and Merge.
Part 4: Troubleshooting Common Issues
My Form Submission Is Not Appearing in Momentum AMS
Review the following:
- Confirm the webhook URL is entered correctly.
- Verify that the form sends a POST request using JSON.
- Confirm that the AgencyID field contains the correct Agency ID.
- Verify that the Form Name field is included.
- Check the form platform's available webhook submission information for errors.
My Submitted Information Is Appearing in the Wrong Fields
Open the Quote Application and review the existing field mapping.
Verify that each form field is assigned to the intended Momentum AMS field.
My Form Fields Are Not Using the Saved Mapping
Confirm that the Form Name in the new submission matches the Form Name used when the original mapping was saved.
If the form has been modified to include additional fields, review the mapping to ensure those fields are assigned correctly.
Part 5: Recommended Best Practices
- Use Descriptive Form Names: Choose names such as Homeowners Quote Application or Commercial Auto Quote Request instead of generic names like Form 1.
- Keep Form Names Consistent: Avoid changing the Form Name unnecessarily because Momentum AMS uses it to recognize saved mappings.
- Test Before Going Live: Submit several sample applications and verify the resulting information.
- Review New Fields: If your form changes, confirm that any new fields are mapped correctly.
- Protect Integration Settings: Limit access to webhook configuration and agency identifiers to authorized personnel.
- Review Submitted Data: Check incoming Quote Applications for accuracy before processing them.
Form Webhook Integration Checklist
Use this checklist to confirm the integration has been configured.
- ☐ Agency ID located and verified.
- ☐ Website form created.
- ☐ AgencyID and Form Name fields configured.
- ☐ Webhook URL entered correctly.
- ☐ POST request and JSON format configured.
- ☐ Test application submitted successfully.
- ☐ Test application located under Quote Applications.
- ☐ Form fields mapped to Momentum AMS fields.
- ☐ Initial application processed using Save and Merge.
- ☐ Additional test submission verified using saved mapping.
Once the webhook is configured and the initial field mapping has been saved, your agency can receive future form submissions through Momentum AMS Quote Applications.
Continue reviewing incoming applications and use the saved mapping to streamline the process of entering quote information into Momentum AMS.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article