🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Insightly Premium Add-on Setup Guide

Updated 5 min read Gravity Forms CRM & Email Marketing
On this page
  1. Step 1: Install and Activate Your License
  2. Step 2: Connect Insightly
  3. Step 3: Create a Lead Feed
  4. Contacts, Organisations and Opportunities
  5. Custom Fields
  6. Duplicates: Update or Keep
  7. Entry Notes, Resend and Failures
  8. Troubleshooting & FAQ
  9. The connection fails with “rejected the API key”.
  10. Insightly refused the data for a lead source or status.
  11. How many API calls does a submission use?
  12. Can one form create leads and contacts?

The Gravity Forms Insightly Premium Add-on sends every form submission to Insightly CRM the moment the form is sent. Create a lead for your sales team to qualify, or a contact linked to its organisation, with an optional opportunity in the right pipeline stage. Lead source and status, owner, custom fields, tags and a note with every answer go along.

This guide covers installation, connecting Insightly, lead and contact feeds, custom fields, opportunities, duplicates, failures and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.9 or higher, any licence
  • Insightly: Any plan with API access (the daily API limit depends on the plan), and the API key of a user who may create the records
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → Insightly. The Gravity Extra License section is at the top.
  3. Paste your license key from your GravityExtra account (My Account → License keys) and click Activate License. The Insightly account settings appear below once the license is active.

Step 2: Connect Insightly

  1. In Insightly, click your profile picture, open User Settings and scroll to API. You will see your API key and, under it, the API URL, for example https://api.na1.insightly.com/v3.1/.
  2. In WordPress, paste the API URL (or just the pod, such as na1) and the API key, then click Save Settings.
  3. Check that Connected to Insightly is shown. The key is never shown again; leave the field empty later to keep it.
  4. Optional: enter a Backup email for failed submissions so no lead is lost if Insightly cannot accept it.
Insightly settings page in Gravity Forms with the GravityExtra license section, the Insightly API URL, a saved API key shown only by its last four characters, a Connected to Insightly status and a backup email address
The license section comes first, then your Insightly account.

Records are created with the permissions of the user who owns the key. Click Test connection after you add lead sources, users, pipelines or custom fields in Insightly to reload the lists.

Step 3: Create a Lead Feed

  1. Open the form, go to Settings → Insightly and click Add New.
  2. Leave Create on A lead and map the fields: email (required), first and last name, phone, mobile, job title, organisation name, website, industry, address and description.
  3. Choose the Lead source and Lead status. The lists come from your Insightly settings and start on your default values.
  4. Pick an Owner: the lead is owned by, and assigned to, that user. Leave it empty to use the API key user.
  5. Add Tags such as website, {form_title} and keep Add a note with every answer on, so the full submission is on the lead.
Insightly feed set to create a lead: email, name, phone, job title, organisation, website, address and description mapped to form fields, lead source Referral, lead status Open - Not Contacted, custom lead fields, owner Sam Lee, tags and a note option
A lead feed with source, status, custom fields, owner and tags.

If you have only one “Full name” text field, map it to First name and leave Last name empty: the last word becomes the last name. A lead always needs a last name in Insightly, so when no name is given the part of the email address before the @ is used.

Contacts, Organisations and Opportunities

Choose A contact under Create when the form comes from a customer you will sell to directly. The organisation name is looked up in Insightly and used when the name matches exactly; otherwise a new organisation is created with the website from the form, and the contact is linked to it.

Tick Create an opportunity to open a deal at the same time:

  • Name with merge tags, for example Demo: {Company:4}.
  • Value: a number or a merge tag such as {Budget:9} or {payment_amount}, with a three-letter currency.
  • Pipeline and stage: every opportunity pipeline with its stages in order.
  • Probability and Expected close in days after the submission.
  • The opportunity is linked to the contact and its organisation, has the same owner, and carries the answers as its details.
Insightly feed Opportunity section: opportunity name with the company merge tag, value from the Budget field, currency USD, pipeline Sales stage Proposal, probability 40 percent, close in 30 days and a custom opportunity field
An opportunity in the Sales pipeline, Proposal stage.

Custom Fields

Custom fields of leads, contacts and opportunities are listed with their label and Insightly name, for example Team size (Team_Size__c). Auto-number and read-only fields are left out. Values are converted to the field type: checkboxes become true or false, numeric, currency and percent fields become numbers, and dates are sent in the Insightly date format, whatever date format your form shows. For a fixed value, choose Add Custom Value on the right and type the text or a merge tag.

Duplicates: Update or Keep

Before creating a record, the add-on searches Insightly by email: leads by EMAIL, contacts by EMAIL_ADDRESS. Converted leads are skipped. Under If the email already exists, choose to update the record with the new values or keep it as it is; tags, the note and the opportunity are added either way.

Entry Notes, Resend and Failures

  • Each entry gets a note such as “Insightly: new contact 77001234 created. Opportunity 99001 created.” and the Insightly box on the entry page links to the record and the opportunity.
  • If Insightly refuses the record, the note shows its message; if a plan limit is reached, the note says so. A refused opportunity or tag does not undo the lead or contact — the note lists what was not saved.
  • Insightly allows 10 requests per second and a daily number of calls that depends on your plan. A short wait is retried once; a daily limit is reported on the entry.
  • Failed submissions are emailed to the backup address, and the Send to Insightly again button retries the entry.
  • With Gravity Forms logging on, only record IDs and HTTP status codes are logged — never names, email addresses or the API key.

Troubleshooting & FAQ

The connection fails with “rejected the API key”.

Copy the key and the API URL again from User Settings → API. Keys of users who are deactivated stop working.

Insightly refused the data for a lead source or status.

The list in the feed is kept for an hour. Click Test connection in the add-on settings to reload it, then choose the value again.

How many API calls does a submission use?

A lead with two tags and a note uses about 5 calls; a new contact with a new organisation and an opportunity about 10. On the Free plan (1,000 calls a day) that is more than 100 submissions a day.

Can one form create leads and contacts?

Yes. Add two feeds with conditional logic, for example a lead for “Just looking” and a contact with an opportunity for “Ready to buy”.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr