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

Gravity Forms Capsule CRM 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 Your Capsule Account
  3. Step 3: Create a Feed
  4. Person
  5. Note
  6. Opportunity
  7. Task
  8. Conditions
  9. Step 4: Check What Was Sent
  10. Limits and What Is Not Included in v1.0
  11. Troubleshooting & FAQ
  12. The settings page says “HTTP 401 … Check the personal access token”.
  13. The Milestone list is empty.
  14. A person was created twice.
  15. The entry note says “no milestone chosen in the feed”.
  16. What happens when I uninstall the add-on?

The Gravity Forms Capsule CRM Premium Add-on sends Gravity Forms entries to Capsule CRM. Each entry creates or updates a person (linked to an organisation), adds the entry as a note, and can open an opportunity and a follow-up task for your team.

This guide covers connecting your Capsule account, creating a feed, what is sent for new and existing people, the limits of version 1.0 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
  • Capsule CRM: A Capsule account and a personal access token
  • 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 → Capsule CRM, enter your key in the Gravity Extra License section and click Activate License.

Step 2: Connect Your Capsule Account

  1. In Capsule, open your name in the top right → My Preferences → API Authentication Tokens and generate a new token. Copy the token.
  2. In WordPress, paste it into Personal access token on Forms → Settings → Capsule CRM and click Save Settings.
  3. The page shows Connected to Capsule as <your name>. If it shows an error such as HTTP 401, the token is wrong or was deleted in Capsule; generate a new one.

The token acts with your Capsule user’s permissions. Opportunities are owned by that user. The token is never shown in the page text, entry notes or logs.

Step 3: Create a Feed

Open a form, go to Settings → Capsule CRM and click Add New. A form can have several feeds, for example one for sales enquiries and one for partner applications.

Person

Map the form fields to the Capsule person. Email is required: the add-on searches Capsule for a person with exactly that address (upper or lower case does not matter). The other fields are optional: first name, last name, phone, job title, organisation name, website, and street, city, state or county, postcode and country.

Person section of a Capsule CRM feed with Email, First name, Last name, Phone, Job title, Organisation name, Website and address fields mapped, the existing-person choice and a Tags field
Map the form fields to the Capsule person.
  • Organisation name: the add-on looks for an organisation with exactly that name and links the person to it, or creates the organisation first.
  • If the person already exists: choose Update to change the name, job title and organisation and add the tags, or Leave the person as it is to only add the note, opportunity and task. Existing email addresses, phone numbers and addresses are never removed.
  • Tags: a comma-separated list, with merge tags allowed, for example Website lead, {Interest:6}. Tags are added to the person; existing tags stay.
  • If the form has no first or last name, a new person is named after the part of the email address before the @.

Note

Add a note to the person with the entry is on by default and sends {all_fields} as plain text. Change the text to anything you like with merge tags, for example Enquiry from {form_title} followed by the message field. The note appears in the person’s history in Capsule.

Opportunity

Tick Create an opportunity for the person to add a sales opportunity to your pipeline:

  • Opportunity name – with merge tags, for example {Company:4} – website enquiry.
  • Milestone – the list shows every milestone of every pipeline in your Capsule account (for example Sales – Qualified).
  • Value – a number or a merge tag such as a budget or total field, and the Currency as a three-letter code (USD, GBP, EUR…). Leave the value empty to create the opportunity without one.
  • Expected to close after – the number of days after the entry; leave it empty for no date.
Opportunity section of the feed with the opportunity checkbox ticked, the name built from the Company field, the milestone Sales – Qualified, a value from the Budget field, currency USD and 30 days to close
The opportunity is added on the milestone you choose.

Task

Tick Create a follow-up task to remind your team to call back. Write the task with merge tags and set Due after (days); the due date uses your WordPress time zone. The task is linked to the person.

Conditions

Tick Enable Condition to send only some entries, for example only when Interest is not Support. Entries that do not match are saved as usual but not sent to Capsule.

Step 4: Check What Was Sent

Every send is written to the entry’s Notes box, with the Capsule ids of what was created or updated, for example Capsule CRM: person 1002 created, note added, opportunity 1004 created, task 1005 created.

Notes box of a Gravity Forms entry with a green Capsule CRM note: person 1002 created, note added, opportunity 1004 created, task 1005 created
The entry note lists everything that was sent.

If Capsule rejects part of the request, an error note says which part failed and why, and the rest is still sent where possible: a failed opportunity does not stop the task. If the person cannot be found or created, nothing else is sent, because the note, opportunity and task need a person. For more detail, enable logging for Capsule CRM in Forms → Settings → Logging.

Limits and What Is Not Included in v1.0

  • Entries are sent once, when the form is submitted. Editing an entry later does not update Capsule, and old entries are not sent in bulk.
  • Capsule custom fields, cases (projects) and file attachments are not sent in version 1.0.
  • People are matched by email address only; organisations by exact name only.
  • Without an active license, feeds are paused and entries are not sent; your forms keep working.

Troubleshooting & FAQ

The settings page says “HTTP 401 … Check the personal access token”.

The token is wrong or was deleted in Capsule. Generate a new one in My Preferences → API Authentication Tokens, paste it and save.

The Milestone list is empty.

Your Capsule account has no pipelines yet, or the token cannot be read. Add a pipeline in Capsule, then reload the feed page (the list is refreshed every ten minutes or when you save a new token).

A person was created twice.

The add-on matches people by email address. A second person appears only when the email address differs, for example when the first person has no email address in Capsule. Merge them in Capsule; later entries use the person with the address.

The entry note says “no milestone chosen in the feed”.

Open the feed and pick a milestone in the Opportunity section, or untick the opportunity.

What happens when I uninstall the add-on?

Forms → Settings → Uninstall removes the feeds, the token and the saved Capsule ids. Nothing is deleted in Capsule.

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