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

Gravity Forms Tripleseat Integration Setup Guide

Updated 8 min read Gravity Forms Integrations A–Z
On this page
  1. Step 1: Install and License the Add-on
  2. Step 2: Connect Your Tripleseat Lead Form
  3. Copy the API Endpoint URL
  4. Save and test the connection
  5. Step 3: Create a Tripleseat Feed
  6. Contact details
  7. Event details and event style
  8. Field Mapping Reference
  9. Tripleseat IDs, tracking and custom fields
  10. Privacy, Consent and Data Handling
  11. Conditional Logic
  12. Developer Filter: gravityextra_tripleseat_lead
  13. Checking Delivery on the Entry Screen
  14. Troubleshooting & FAQ
  15. An inquiry did not reach Tripleseat. What happens?
  16. Leads are rejected even though the connection test passed.
  17. The note says first name, last name, email and phone are required.
  18. The event date, time or guest count looks wrong in Tripleseat.
  19. The lead lands in the wrong venue or lead form.
  20. Resource Hub

Private event inquiries are time-sensitive: the venue that answers first usually wins the booking. The Gravity Forms Tripleseat Premium Add-on sends every inquiry from your website form straight into Tripleseat as a new lead, complete with contact details, event date and times, guest count, event style, venue location, consent choices and campaign tracking. Your event coordinators see the lead in Tripleseat immediately, without copying anything from an email.

This guide covers connecting your Tripleseat lead form, building a feed, mapping fields, handling consent, and troubleshooting delivery.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.5 or higher
  • Tripleseat account: A Tripleseat lead form, with access to Settings → Lead Forms → View Setup Codes to copy its API Endpoint URL
  • Tripleseat setting: “Enable Spam Detection on Embedded Forms” turned OFF in your Tripleseat account
  • GravityExtra license: The Tripleseat 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 → Tripleseat.
  3. Enter your license key in the Gravity Extra License section and save. The Tripleseat connection settings appear once the license is active.

Step 2: Connect Your Tripleseat Lead Form

Copy the API Endpoint URL

In Tripleseat go to Settings → Lead Forms, open your lead form, click View Setup Codes and copy the API Endpoint URL. It contains your public_key and, for many lead forms, a lead_form_id.

Save and test the connection

Paste the whole URL, or only the public key, into API Endpoint URL or Public Key and click Save Settings. Saving runs a validation-only request against Tripleseat: the details are checked but no lead is created. When it succeeds you see a green check and the message “Connected. Tripleseat accepted a validation-only test lead (nothing was created).”

  • If Tripleseat rejects the key, the setting is not saved and the error from Tripleseat is shown under the field.
  • If Tripleseat cannot be reached at that moment, the setting is still saved and an amber status line explains the network problem.
  • If the add-on cannot find a public key in what you pasted, it asks you to paste the API Endpoint URL that contains public_key=.

Set Backup email for failed leads to the inbox that should receive an inquiry when Tripleseat cannot accept it. It defaults to the site admin email; leave it empty to turn it off.

Tripleseat Lead Form API settings showing a connected API endpoint and backup email in Gravity Forms
Forms → Settings → Tripleseat after a successful validation-only connection test.

Turn off Tripleseat spam detection

Tripleseat’s “Enable Spam Detection on Embedded Forms” setting must be turned OFF. When it is on, leads sent from your website may be rejected. Use Gravity Forms’ own anti-spam tools (such as the honeypot or reCAPTCHA) on the form instead.

Step 3: Create a Tripleseat Feed

Open your inquiry form, go to Settings → Tripleseat and click Add New. The Add New button is available once a public key has been saved in Step 2.

Contact details

Tripleseat requires first name, last name, email and phone on every lead, so these four mappings are marked with a red asterisk. Make the matching fields required on your form too. Company is optional. Set a fixed Contact Preference (Email or Phone), or choose a field in Contact Preference from field whose choice values are Email or Phone.

Tripleseat feed contact mapping with first name, last name, email, phone, company and contact preference
Contact mapping with the four fields Tripleseat requires.

Event details and event style

Map the event name, date, start and end time, guest count and message. Set a default Event Style, or let visitors pick it with Event Style from field; that field’s choice values must be onpremise, pickup, dropoff, catering or largeparty. For catering, pickup and drop-off events you can also map an Offsite / Catering Address from a Gravity Forms Address field.

Tripleseat feed event details mapping with event name, date, start and end time, guest count, message and event style
Event Details plus a default event style, overridden by the visitor’s Event Type choice.

Field Mapping Reference

Feed setting Tripleseat field How it is sent
First Name, Last Name, Email, Phone first_name, last_name, email_address, phone_number Required. If any is empty, the lead is not sent.
Company company As entered
Contact Preference contact_preference Email or Phone; the field value wins when it matches
Event Name / Description event_description As entered
Event Date event_date Converted to MM/DD/YYYY
Start Time, End Time start_time, end_time Converted to 12-hour format, e.g. 6:30 PM
Guest Count guest_count Digits only, sent as a number
Additional Information additional_information Trimmed to Tripleseat’s 2,500-character limit
Event Style event_style Only the five supported values are sent
Offsite / Catering Address offsite_address_attributes Street, line 2, city, state, ZIP code
Email Opt-in Field email_opt_in true when the field has a value, otherwise false
GDPR Consent Field gdpr_consent_granted Sent as 1 only when the field has a value
Location, Lead Source, Referral Source ID location_id, lead_source_id, referral_source_id Numeric IDs or merge tags; non-numeric results are skipped
Referral Source “Other” referral_source_other Free-text answer
Lead Form ID lead_form_id Feed value, otherwise the ID in your API Endpoint URL
Campaign / UTM Fields campaign_source, campaign_medium, campaign_name, campaign_term, campaign_content, gclid From hidden fields
Tripleseat Custom Fields custom_field_values_attributes One entry per numeric custom field ID

Tripleseat IDs, tracking and custom fields

Location, lead source and referral source are numeric IDs from your Tripleseat account. Leave Location ID empty to use the lead form default, or route by venue with a merge tag such as {Venue:13:value}, where the Venue drop-down’s choice values are your Tripleseat location IDs. Lead Form ID is only needed for a Dynamic lead form.

Tripleseat feed IDs with a location ID merge tag, lead source, referral source and lead form ID
Location ID routed by the Venue field with a merge tag.

For campaign tracking, add Hidden fields with Allow field to be populated dynamically enabled (parameter names such as utm_source and gclid) and map them. Under Tripleseat Custom Fields, enter the numeric custom field ID and choose the form field that holds its value.

Tripleseat feed UTM and gclid mapping, custom field mapping and conditional logic
Campaign fields, a Tripleseat custom field and the conditional logic switch.

The Consent section of the feed maps two optional fields:

  • Email Opt-in Field: use an unchecked Checkbox or Consent field such as “Email me seasonal menus and offers”. Tripleseat receives email_opt_in as true only when the visitor ticks it.
  • GDPR Consent Field: when the mapped field has a value, Tripleseat records that GDPR consent was granted. When it is empty, nothing is sent for consent.
  • Backup email: contains the inquiry details (contact, event and address data), the error and a link to the entry. Send it to a business inbox your team controls.
  • Public key: stored in a masked settings field and never included in entry notes or backup emails. The connection test uses placeholder contact details and creates no lead.
Tripleseat feed Consent section with email opt-in and GDPR consent fields
The Consent section maps the email opt-in and GDPR consent checkboxes.

Conditional Logic

Turn on Conditional Logic and choose Only send when conditions are met to decide which inquiries reach Tripleseat. For example, send only when Number of Guests is greater than 10, keep job applications that share the form out of Tripleseat, or create one feed per venue with a fixed Location ID and a condition on the Venue field.

Developer Filter: gravityextra_tripleseat_lead

Use the gravityextra_tripleseat_lead filter to adjust the lead before it is sent. It passes $lead (the Tripleseat lead fields), $feed, $entry and $form, and must return the lead array. This example marks web inquiries in the event name on form 5:

functions.php
PHP
// Prefix the event name on Tripleseat leads from form 5
add_filter( 'gravityextra_tripleseat_lead', function( $lead, $feed, $entry, $form ) {
    if ( (int) $form['id'] !== 5 ) {
        return $lead;
    }
    if ( ! empty( $lead['event_description'] ) ) {
        $lead['event_description'] = 'Web: ' . $lead['event_description'];
    }
    return $lead;
}, 10, 4 );

Checking Delivery on the Entry Screen

Entries from a form with an active Tripleseat feed show a Tripleseat box with the status Lead sent, Not delivered or Not sent, and each attempt adds an entry note.

Tripleseat status box on a Gravity Forms entry showing Lead sent
The Tripleseat status box with the Send to Tripleseat again button.

Resending a delivered entry creates a second lead. Tripleseat creates a new lead every time it receives a request. For entries marked Not delivered the box shows Send to Tripleseat again. Once an entry is Lead sent, the button changes to Send again anyway with a notice, and you are asked to confirm before a second lead is created (version 1.0.1 and later).

Gravity Forms entry note confirming the lead was sent to Tripleseat
The success note added when Tripleseat accepts the inquiry.

Troubleshooting & FAQ

An inquiry did not reach Tripleseat. What happens?

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

Leads are rejected even though the connection test passed.

Check that “Enable Spam Detection on Embedded Forms” is turned OFF in Tripleseat. Also read the error in the entry note: Tripleseat names the field it did not accept, for example a location ID that does not exist in your account.

The note says first name, last name, email and phone are required.

Tripleseat will not create a lead without all four. The note lists what was missing. Map the fields in the feed and make them required on the form; these entries are not sent and no backup email is created, so resend them after completing the data.

The event date, time or guest count looks wrong in Tripleseat.

Dates are sent as MM/DD/YYYY and times in 12-hour format, so use Gravity Forms Date and Time fields. Guest count keeps only digits, so “about 85” becomes 85. Messages longer than 2,500 characters are trimmed.

The lead lands in the wrong venue or lead form.

Confirm that the Location ID (or the merge tag’s choice values) are numeric Tripleseat location IDs; anything non-numeric is skipped and the lead form default is used. For a Dynamic lead form, set Lead Form ID in the feed. A note about the GravityExtra license means leads are paused until the license is active again, and 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