Send WordPress form leads to GuardenerAI.

Step by step

1. Create a key that can write

   In GuardenerAI open Settings, API keys and create a key with Role Member (read and write records) and Scope Read and write. Copy it when it is shown; it is shown once.

2. Add a webhook to the form

   In your form plugin’s webhook settings, set the request URL to https://YOUR-ORG.guardenerai.com/api/leads, the method to POST and the format to JSON. Add a request header named X-Api-Key with your key as its value. Gravity Forms and WPForms call this Request Headers; CF7 to Webhook adds a tab to the Contact Form 7 editor where you set the URL and headers.

3. Map the form fields

   Map your fields to the lead’s field names: firstName, lastName, email, phone, company and message for the visitor’s note. Add a fixed sourceMedium of website form, and sourceCampaign if you want to tell forms apart. Leave source out unless an admin has added a matching code to your lead source list.

   Copy

   {
     "firstName": "Dana",
     "lastName": "Whitlock",
     "email": "dana@fernhill.example",
     "phone": "+1 555 0142",
     "company": "Fernhill Dental",
     "message": "Can we book a call next week?",
     "sourceMedium": "website form",
     "sourceCampaign": "contact page"
   }

4. Submit a test entry

   Fill in the form yourself and check the new lead under Leads in GuardenerAI. If nothing arrives, the add-on’s log will show the answer: 401 means the key is wrong, 403 api_key_read_only means it cannot write, and 400 lists the fields that failed.