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

Gravity Forms BoldTrail (kvCORE) Integration Setup Guide

Updated 8 min read Gravity Forms CRM & Email Marketing
On this page
  1. Step 1: Install and License the Add-on
  2. Step 2: Connect BoldTrail with an API Token
  3. Generate the token
  4. Save and test the connection
  5. The one-year token reminder
  6. Step 3: Create a BoldTrail Feed
  7. Contact details
  8. Addresses and duplicate check
  9. Lead details, agent and consent
  10. Tags and note
  11. Field Mapping Reference
  12. Privacy and Consent
  13. Conditional Logic
  14. Developer Filters
  15. Checking Delivery on the Entry Screen
  16. Partial deliveries resume where they stopped
  17. Troubleshooting & FAQ
  18. A lead did not reach BoldTrail. What happens?
  19. The connection says BoldTrail rejected the token.
  20. Assign to Agent is a text box instead of a list.
  21. A returning visitor did not create a new contact.
  22. The note says a contact name, email or phone is required.
  23. Resource Hub

In real estate, the agent who follows up first usually wins the listing. The Gravity Forms BoldTrail (kvCORE) Premium Add-on sends every home valuation request, listing inquiry or contact form on your website to BoldTrail as a contact, with the deal type, property of interest, source, assigned agent and communication consent already set. It then adds your tags and a note with the visitor’s message.

This guide covers the API token, feed mapping, duplicate handling, the yearly token renewal and resending.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.5 or higher
  • BoldTrail (kvCORE) account: Access to Lead Engine → Lead Dropbox → My API Tokens to generate a token
  • GravityExtra license: The BoldTrail add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and License the Add-on

  1. Go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Open Forms → Settings → BoldTrail (kvCORE).
  3. Enter your license key in the Gravity Extra License section and save. The API settings appear once the license is active.

Step 2: Connect BoldTrail with an API Token

Generate the token

In BoldTrail open Lead Engine → Lead Dropbox → My API Tokens, choose the token type Contacts and click Generate. Choose All instead if you want to pick the assigned agent from a list in the feed. BoldTrail allows up to three tokens; treat each one like a password.

Save and test the connection

  • API Token (required): paste it and click Save Settings. It is stored in a masked password field.
  • Token generated on: the day you clicked Generate. It is filled in with today’s date when you save a new token; correct it if the token is older.
  • Account ID (super accounts only): only for super-account tokens, the ID of the child account that should receive the leads. Leave it empty for a normal account.
  • Connection: the add-on reads one contact to confirm the token works and shows “Connected to BoldTrail (kvCORE).” with the date the token stays valid until. Click Test connection to check again now.
  • Backup email for failed leads: defaults to the site admin email. If BoldTrail cannot be reached, the lead details are emailed here. Leave it empty to turn it off.
BoldTrail kvCORE API settings in Gravity Forms with masked token, token generation date, connected status, token validity date and Test connection button
Forms → Settings → BoldTrail (kvCORE) with a connected token and its expiry date.

The one-year token reminder

Each BoldTrail token stays valid for one year from the day it was generated and cannot be renewed; deleting a token only frees its slot. Because BoldTrail does not report the expiry date, the add-on counts a year from Token generated on. Starting 30 days before that date, a reminder appears next to the token and as a notice on the Dashboard, the Plugins screen and Gravity Forms screens for users who can manage Gravity Forms settings. After the date it turns red and says the token has expired.

BoldTrail connection status with a reminder that the API token expires in 20 days and should be replaced
The reminder shown 20 days before the token expires.

Replace the token before it expires. Once the year is over, BoldTrail rejects every new lead. Generate a new token in Lead Dropbox → My API Tokens, paste it into the add-on settings and save; the generation date resets to today automatically.

Step 3: Create a BoldTrail Feed

Open your form, go to Settings → BoldTrail (kvCORE) and click Add New. The button is available once an API token is saved.

Contact details

Map First Name and Last Name, or a single Full Name field, which is split so the last word becomes the last name. Map email and the primary cell phone, plus home phone, work phone and a second email if you collect them. Phone numbers are sent as digits only. A name, email or phone is required.

BoldTrail feed contact mapping with first name, last name, email and cell phone mapped to Gravity Forms fields
Contact mapping for a Home Valuation Request form.

Addresses and duplicate check

Contact Address is where the person lives. Property of Interest is the home they asked about, such as the address on a valuation or listing inquiry form. US state names are converted to two-letter codes.

BoldTrail does not document a duplicate check, so with Always create a new contact left off (recommended), the add-on first looks the email up in BoldTrail. When the contact already exists, it is reused and only the tags and note are added.

BoldTrail feed Contact Address and Property of Interest mapping with the Always create a new contact toggle turned off
The property address mapped as Property of Interest, with the duplicate check on.

Tick one or more Deal Types (Buyer, Seller, Renter), or pick a Deal Type from field: answers containing “buy”, “sell” or “rent” are recognized and replace the boxes when the field has a value. Set the Contact Status, Lead Source and Capture Method. Assign to Agent lists your agents when the token type is User or All; otherwise enter the agent’s BoldTrail user ID, or leave it empty to let BoldTrail lead routing decide.

Under Communication Consent, map consent checkboxes for automated emails, phone calls and text messages. A mapped option is turned on only if the visitor ticked the box; unmapped options keep the BoldTrail default (on). When text consent is given, the submission time is sent as the TCPA opt-in date.

BoldTrail feed Lead Details with Seller deal type, deal type from field, contact status, lead source, capture method, assigned agent and text message consent
Lead Details with the agent list and a text message consent checkbox.

Tags and note

Tags is a comma-separated list with merge tags, for example website, home-valuation, {Timeline:6}. The Note combines the visitor’s message with any Extra Fields, one “Label: value” line each, under the Note Title. BoldTrail’s API has no custom contact fields, so extra answers go here. BoldTrail turns every #word in a note into a tag; leave Turn #words typed by visitors into contact tags off so text like “Apt #12” does not create tags.

BoldTrail feed Tags and Note settings with a tag list, note title merge tag, message field, two extra fields and the hashtag toggle off
Tags & Note with the timeline and bedroom count added to the note.

Field Mapping Reference

Feed setting BoldTrail field How it is sent
First / Last Name, or Full Name first_name, last_name Full Name split at the last space
Email, Second Email email, second_email As entered; email is used for the duplicate check
Cell, Home, Work Phone cell_phone_1, home_phone, work_phone Digits only
Contact Address primary_address, primary_city, primary_state, primary_zip US states as two-letter codes
Property of Interest poi_address, poi_city, poi_state, poi_zip US states as two-letter codes
Deal Type deal_type buyer, seller and/or renter
Contact Status status New, Prospect, Active, Client or Sphere
Lead Source, Capture Method source, capture_method Text or merge tags
Assign to Agent assigned_agent_id Empty uses lead routing
Communication Consent email_optin, phone_on, text_on 1 when ticked, 0 when not; text consent adds the opt-in date
Tags Contact tags Added after the contact exists
Note Title, Message, Extra Fields Contact note Added after the contact exists
  • The token stays private: it is kept in a masked field and replaced with “***” in error messages, entry notes, logs and backup emails.
  • Consent (TCPA): map your consent checkboxes instead of relying on BoldTrail’s defaults, so a visitor who did not agree to texts is never opted in.
  • Backup email contents: it lists the contact fields, tags and note, the reason and an entry link. Send it to an inbox your team controls.

Conditional Logic

Enable Conditional Logic and choose Only send when conditions are met. For example, create two feeds that assign buyer and seller inquiries to different agents.

Developer Filters

Use gravityextra_kvcore_contact to change the contact body before it is created, and gravityextra_kvcore_followups to change the tags and note (an array with tags and note). Both pass $feed, $entry and $form and must return the changed value. This example sets the lead source from a hidden utm_source field on form 4:

functions.php
PHP
// Use the ad platform as the BoldTrail source (form 4, field 10 = utm_source)
add_filter( 'gravityextra_kvcore_contact', function( $contact, $feed, $entry, $form ) {
    if ( (int) $form['id'] !== 4 ) {
        return $contact;
    }
    $utm = strtolower( trim( rgar( $entry, '10' ) ) );
    if ( $utm === 'facebook' ) {
        $contact['source'] = 'Facebook Ads';
    }
    return $contact;
}, 10, 4 );

Checking Delivery on the Entry Screen

Entries from a form with an active BoldTrail feed show a BoldTrail (kvCORE) box with the status, the BoldTrail Contact ID (marked “existing contact” when it was matched by email) and whether the tags and note were added. The entry notes record each step.

BoldTrail status box on a Gravity Forms entry showing Contact sent, the contact ID, tags and note added, and Send again anyway
A delivered entry with the contact ID, tags and note.
Gravity Forms entry notes confirming the contact was created in BoldTrail, tags were added and the note was added
Entry notes for the contact, tags and note.

Partial deliveries resume where they stopped

The contact ID is saved before the tags and note are added, so a later problem can never create a second contact. If BoldTrail accepts the contact but the tags or note fail, the status becomes Contact sent — tags or note missing and the button changes to Retry missing tags / note, which only adds what is missing to the same contact.

BoldTrail status box showing the contact was sent but tags were not added, with a Retry missing tags or note button
Tags failed while the note was added; the retry only sends the tags.

Resending a delivered entry asks first. When an entry is fully delivered, the box explains that BoldTrail already has the lead and shows Send again anyway. You are asked to confirm, and the add-on then adds the tags and note to the same contact again; no new contact is created. For entries marked Not delivered, the button is Send to BoldTrail again.

Troubleshooting & FAQ

A lead did not reach BoldTrail. What happens?

The entry is kept, the status becomes Not delivered, a note records the reason (“BoldTrail did not accept the contact: …”) and the backup email “BoldTrail lead not delivered — [form name]” is sent. Fix the cause and click Send to BoldTrail again. It reruns every active BoldTrail feed whose conditions match, and is available to users who can edit entries.

The connection says BoldTrail rejected the token.

The token may be mistyped or more than a year old. Generate a new one in Lead Dropbox → My API Tokens, save it, click Test connection and resend the affected entries. Super-account tokens also need the child Account ID.

Assign to Agent is a text box instead of a list.

Listing agents needs a token of type User or All. Generate one of those, or enter the agent’s BoldTrail user ID in the box. Leave it empty to use BoldTrail lead routing.

A returning visitor did not create a new contact.

That is the duplicate check: the email matched an existing contact, so the add-on reused it and added the new tags and note. Turn on Always create a new contact in the feed if you prefer a new contact every time.

The note says a contact name, email or phone is required.

Map at least one of them in the feed and make it required on the form, then resend the entry. A note about the GravityExtra license means leads are paused until the license is active again; Forms → Settings → Logging gives a detailed trace.

Resource Hub

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