Form Connect

Send website form leads straight into Aloware.

Form Connect sends the leads your website forms collect straight into Aloware. You add one script to the page, call one function with your API key, and every submission of the bound form becomes a contact in your account.

  • Where to find it: Integrations menu > Form Connect in Aloware
  • What you add: one script tag (Vanilla JS or jQuery) and an alowareInit call
  • Auth: your Aloware API key, passed as the first argument
Form Connect screenshot
Know what goes on your page: the key you pass to alowareInit is your full account API token. Anyone can read it in your site's page source, and the same token works for the whole API (texts, calls, contacts, Power Dialer) and for MCP. There is no form-only token yet. If that is a concern, send your form data to the Lead API from your own server instead, where the token stays private.

Setup

Step 1: load the script

Put one of these tags on the page right before </body>. Pick the plain JavaScript build if your site has no jQuery.

<script src="https://app.aloware.io/form/vanilla-js-lead-api.min.js"></script>

For sites that already run jQuery, use this one instead:

<script src="https://app.aloware.io/form/jquery-lead-api.min.js"></script>

Step 2: call alowareInit

Once the script has loaded, call alowareInit. It takes two arguments: your API key and an options object.

<script>
    alowareInit("[API_TOKEN]", { force_update: true });
</script>

Put your own key in place of [API_TOKEN]. The options change how leads are handled; each one is listed below.

Step 3: test it

Submit your form yourself and check that the lead shows up. You can look for it in the Aloware dashboard or confirm it through the Aloware API.

Options for alowareInit

Every option is optional. Leave one out and the default applies. Use them to pick the form, route the lead to a line or user, tag it, start a sequence, or update a contact that already exists.

form_id (optional)Specify the ID of the form you want to bind to Aloware. If not set, the integration will bind to the first form on the page.
line_id (optional)Assign a specific Aloware line ID to associate with the captured leads.
sequence_id (optional)Set a sequence ID to trigger a specific automation sequence in Aloware.
user_id (optional)Assign a user ID to associate with the leads.
tag_id (optional)Apply a specific tag ID to the captured leads.
disposition_status_id (optional)Set a disposition status ID for the leads.
force_update (optional)If set to `true`, forces an update to the existing lead in Aloware with new data from the form. Defaults to `false`.
force_update_sequence (optional)If set to `true`, forces an update to the existing lead's automation sequence in Aloware. Defaults to `false`.

Need more?

For other API functions or any question about this setup, write to support@aloware.com and tell us what you need.

Need a hand?

Our support team can help you set this up.

Contact support