Contact Import API

I. Prepare a Basic Form in GrooveForm

✅ Prepare Your Form.

✅ No need to worry about styling since the form is never exposed to visitors

✅ Configure the list, tags, emails, sequences as you usually do for every form

✅ When finished, copy the HTML Form Code for the next step

II. Prepare a Basic Site in GroovePages

✅ Create a New Site.

✅ Create 3 pages: Home page (index), a Subscribe page and a Thank You page

✅ Don't worry about publishing just yet

✅ On the Home Page - add two buttons:
CONTACT TEST - for testing the JavaScript
IMPORT TEST - for testing the import functionality
✅ Details & URLs will follow later

III. Use AI (ChatGPT or Copilot) To Clean the HTML Form

Use This Prompt in ChatGPT4o / Google Gemini / GrooveAI with code output (all tested): 👇

Hello. I will paste a form's HTML code and I need it cleaned up as follows
- remove everything non-essential for the form's operation
- remove all inner DIVs, style and class attributes
- align all form elements vertically
- add simple borders, padding, margins and backgrounds for form fields and button via CSS
- output the the style and form only with the enclosing tags. no need for html and body
- make sure each input field has an id attribute, including hidden fields, leaving existing IDs in place
- make sure the form has an id="myform"[paste raw HTML here]

IV. AI Prompt 2 - Generate Test URLs

Use This Prompt in ChatGPT or Copilot (both tested): 👇

Hello. Please generate me an encoded url that contains the following
- base url is "https://mydomain.com/subscribe"
- parameter with name = myemail and value "[email protected]"
- parameter with name = myfirst_name and value "name"
- For the second one add the parameter pair mysubmit=1
Please output both URLs on separate lines.
Thanks.

[replace the "base url" with the complete url of your sample form, and provide the contact's email and first name]

The result should look like
https://mydomain.com/subscribe?myemail=test%40mydomain.com&myfirst_name=name
https://mydomain.com/subscribe?myemail=test%40mydomain.com&myfirst_name=name&mysubmit=1

Add the generated URL to each button on the HOME page.

V. Copy This JavaScript Code to the second Code Embed Element

    <script type="text/javascript">
        document.addEventListener("DOMContentLoaded", function() {
        function getQueryParams() {
            const params = {};
            const queryString = window.location.search.substring(1);
            const regex = /([^&=]+)=([^&]*)/g;
            let m;
            while ((m = regex.exec(queryString)) !== null) {
                params[decodeURIComponent(m[1])] = decodeURIComponent(m[2]);
            }
            return params;
        }

        function setFormFields(params, formIdSuffix) {
            Object.keys(params).forEach(key => {
                if (key.startsWith('my')) {
                    const fieldId = key.substring(2) + '_' + formIdSuffix;
                    const field = document.getElementById(fieldId);
                    if (field) {
                        field.value = params[key];
                    }
                }
            });
        }

        function shouldAutoSubmit(params) {
            return params.mysubmit && params.mysubmit === '1';
        }

        function disableAutocomplete(form) {
            form.setAttribute('autocomplete', 'off');
            const inputs = form.querySelectorAll('input');
            inputs.forEach(input => {
                input.setAttribute('autocomplete', 'off');
            });
        }

        const form = document.getElementById('myform');
        const formIdField = document.getElementById('formid');
        const formIdSuffix = formIdField ? formIdField.value : '';

        disableAutocomplete(form);
        const queryParams = getQueryParams();
        
        /* alert(formIdSuffix); */
        
        setFormFields(queryParams, formIdSuffix);

        if (shouldAutoSubmit(queryParams)) {
            form.submit();
        }
    });

    </script>

VI. Testing The First Button - Contact Test

You should see the name and the email appear in the form. This is validates the JavaScript functionality of preparing the form

VI. Testing The First Button - Import Test

You should see contact with the email show up in the list the form is attached to

VII. Copy The Subscribe Page to your published GroovePages site for deployment

✅ Change the page slug if necessary. in the example below, the slug is "api"
✅ Note the complete URL of your API

https://publishedsite.com/api?myemail=test%40mydomain.com&myfirst_name=name&mysubmit=1

VIII. API Implementation

✅ Choose an integration platform is to be able to generate an Encoded URL as the API endpoint
✅ Pabbly Connect has a perfect solution just for this (fully tested and vetted).

IX. Further Improvements

GrooveMail forms have a number of other fields that can be captured, like last_name as an example. In order to include it in the API, the url needs an additional parameter for it, prefixed with "my" as the field name. See example below and follow the same format for additional fields if necessary.

https://publishedsite.com/api?myemail=test%40mydomain.com&myfirst_name=name&mylast_name=lastname&mysubmit=1

X. Caveats

✅ This API solution is perfect for single contact imports. The raw HTML GrooveForm contains hidden fields used by the Groove platform. This may change for time to time as such, the form may need to be recreated via the AI prompt and updated on the API page
✅ This API solution can be used for bulk inserts – however, GrooveMail or the Groove platform may take certain actions against against it in the future.

Disclaimer

This page contains affiliate links. For details, please visit the Affiliate Disclosure page from the link below.

10-Point-Plan For A GrooveMail Contact Import API

Leveraging GrooveMail HTML Forms & the Power of Javascript

I. Prepare a Basic Form in GrooveForm

II. Prepare a Basic Site in GroovePages

III. Use AI (ChatGPT or Copilot) To Clean the HTML Form

V. Copy This JavaScript Code to the second Code Embed Element

VI. Testing The First Button - Contact Test

VI. Testing The First Button - Import Test

VII. Copy The Subscribe Page to your published GroovePages site for deployment

VIII. API Implementation

IX. Further Improvements

X. Caveats

Disclaimer

10-Point-Plan For A GrooveMail Contact Import API

Leveraging GrooveMail HTML Forms & the Power of Javascript

I. Prepare a Basic Form in GrooveForm

II. Prepare a Basic Site in GroovePages

III. Use AI (ChatGPT or Copilot) To Clean the HTML Form

V. Copy This JavaScript Code to the second Code Embed Element

VI. Testing The First Button - Contact Test

VI. Testing The First Button - Import Test

VII. Copy The Subscribe Page to your published GroovePages site for deployment

VIII. API Implementation

IX. Further Improvements

X. Caveats

Disclaimer

This website uses cookies