🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 28, 2026

How to Add Gravity Forms Submissions to SurveySparrow and Share Surveys

GravityExtra
How to Add Gravity Forms Submissions to SurveySparrow and Share Surveys

You collect email addresses, names and phone numbers through your Gravity Forms every day — on sign-ups, purchases, support requests and event registrations. The question is what happens next. If you run your customer feedback and NPS programme in SurveySparrow, those people should land there as contacts, and often they should get a survey invite while the experience is still fresh. Doing that by hand, exporting a CSV and importing it later, is slow and loses the moment. The Gravity Forms SurveySparrow Premium Add-on closes that gap: every submission becomes a SurveySparrow contact, and — if you choose — an automatic survey invite by email or SMS, the instant the form is submitted.

Why connect Gravity Forms to SurveySparrow

SurveySparrow is a conversational survey and experience-management platform: NPS, CSAT, CES, 360 feedback and more, with contacts, shares and reminders handled through one API. The hard part is getting the right people into it at the right time. For a huge number of sites, that right time is the moment a Gravity Form is submitted: a new customer, a finished purchase, a closed ticket, a booked event. This add-on wires the two together, so the contact is created and the survey goes out the instant the form is submitted — no exports, no manual imports, no stale lists.

A note on the SurveySparrow plan you need

To be clear up front: the SurveySparrow REST API is part of a SurveySparrow plan that includes API access. You generate your access token from a private app in your SurveySparrow account once your plan includes the API. This add-on connects to SurveySparrow with your own token; it does not include a SurveySparrow subscription and does not work around the plan requirement. If you already pay for a SurveySparrow plan with API access, this add-on puts that subscription to work straight from your forms.

Pick your data-center region

SurveySparrow runs separate data-centers, and your account lives in one of them. That means you must tell the add-on which region to talk to: the US host api.surveysparrow.com or the EU host eu-api.surveysparrow.com. This is a one-time setting on the settings page, and it matters — an EU account will reject requests sent to the US host, and the other way round. Choosing the region that matches your account is the first thing to get right, and the Test connection button confirms you have it right before you build a single feed.

Add a contact, or also share a survey

Each feed does one of two things. In Add the person as a SurveySparrow contact mode it creates the contact from the fields you map — email, name, mobile and custom properties — and stores the contact id on the entry. In Share a survey with the person mode it goes further: it posts a survey share for the survey id you choose, by email or SMS, with the contact attached, so SurveySparrow sends the invite straight away. Because the action is set per feed, one form can simply build your contact list on one feed and send a feedback survey on another once a condition is met.

What you need before you start

You need Gravity Forms 2.9 or newer, a WordPress site on PHP 7.4 or newer, and a SurveySparrow account on a plan with API access. You will also need to know your data-center region (US or EU). The add-on only ever contacts the SurveySparrow REST API at the region host you choose — api.surveysparrow.com or eu-api.surveysparrow.com — and nothing else.

Step 1: get your SurveySparrow access token

In SurveySparrow open Settings, then Apps & Integrations, create a private app, and generate an access token. Treat it like a password: you paste it into the add-on once, and it is stored encrypted on your own site from then on. Note which data-center your account uses so you can pick the right region in the next step.

Step 2: connect the add-on

In WordPress go to Forms → Settings → SurveySparrow, activate your GravityExtra license key, paste the SurveySparrow token into the token field, and choose your data-center region (US or EU). The token field is a password field, the token is encrypted with AES-256-GCM before it reaches the database, and it is never shown again in clear. The Test connection button then confirms the token and region work together — it asks SurveySparrow for your surveys — without adding anyone or sharing a survey.

The SurveySparrow settings page in Gravity Forms: license key, access token, data-center region and a Test connection button
Paste your token, pick your region, and confirm both with Test connection.

If your server cannot encrypt secrets, the add-on tells you and lets you define the token with the GFSSP_API_KEY constant in wp-config.php instead (and the region with GFSSP_REGION); the token field is then replaced with a short note and nothing is stored in the database.

Step 3: add a feed to a form

Open a form, go to Settings → SurveySparrow, and add a feed. Choose Add the person as a SurveySparrow contact or Share a survey with the person. Then map the Contact fields: the email, first and last name, and mobile number, each from a merge tag from your form. If you are sharing a survey, enter the numeric survey id and choose the channel, email or SMS.

The SurveySparrow feed in Gravity Forms: add a contact or share a survey, the survey id and the mapped fields
A feed maps the person’s details and chooses add-contact or share-a-survey.

Mapping fields and custom properties

Every contact field accepts Gravity Forms merge tags, so you build the contact straight from the submission. Map the email from your email field with {Email:2}, the name from a name field, and the mobile from a phone field in international format such as +15551234567. You can also send up to two custom properties: give the property name exactly as it is in SurveySparrow and map its value from a form field, for example a company property with the value {Company:4}. An email is needed for an email invite and to add most contacts; a mobile number is needed for an SMS invite.

Step 4: test and watch the entries

Send a test submission. Each entry records a note of what happened and keeps the SurveySparrow contact id and — when a survey is shared — the share id. Three merge tags, {surveysparrow_contact}, {surveysparrow_share} and {surveysparrow_status}, are available in your Gravity Forms notifications, so your admin e-mail can carry the contact and share references to your team automatically.

A Gravity Forms entry screen showing the SurveySparrow note with the contact that was added
The entry note keeps the contact that was added and any survey that was shared.

Clear errors and safe retries

If a SurveySparrow call fails, the form submission is still saved — you never lose a lead — and the entry note carries the HTTP status so you know whether it was an invalid token or wrong region (401), a missing required field such as the email (422), or rate limiting (429). The add-on acts once per entry and never sends a survey invite twice: a “done” marker and a short per-entry lock stop a resend or a retry from adding the same contact again or sending a second invite. Fix the cause, resend the feed from the entry, and the action runs exactly once.

Where it fits: real-world examples

Because every field is mapped from the form, the add-on bends to how you actually work. A shop can add every new customer to SurveySparrow from the checkout form and send a CSAT survey by email straight after the purchase. A support team can share an NPS survey by SMS the moment a help request is closed through a form. A membership or event site can build its contact list from sign-ups and send a feedback survey only to a chosen audience through conditional logic. A B2B site can pass a custom property such as the company or plan tier with each contact, so the survey is personalised and the results are easy to segment. In each case the person lands in SurveySparrow with the data you already collected, and the invite goes out while the experience is fresh.

Your surveys, contacts and reminder settings stay in SurveySparrow, where they belong. Whatever surveys, channels and contact properties you maintain in your SurveySparrow account are what the add-on uses; the feed only ever maps your fields and says add a contact or share a survey. That means you can change a survey, add a contact property, or adjust your reminders inside SurveySparrow without touching your forms.

Privacy and security

Your SurveySparrow access token is encrypted at rest and never shown again, never written to an entry, and never written to a log. It travels only in the Bearer Authorization header, never in the URL or the request body. The add-on fixes the host to the region host you chose over https with certificate verification on, and never follows a redirect, so the token cannot be sent anywhere else. Error messages have the token stripped out before they are shown or stored. The only outbound request the add-on ever makes is to SurveySparrow, and if that request fails your form submission is still saved so no lead is lost.

Put it to work

From a sign-up to a closed support ticket, the Gravity Forms SurveySparrow add-on takes the busywork out of feedback: add the contact from the form, share the right survey by email or SMS, and keep the contact and share references with the entry. You will need a SurveySparrow plan with API access, and you will choose your data-center region to match your account. See the full setup guide for every field and option, then get the Gravity Forms SurveySparrow Premium Add-on and turn your next submission into a contact and a survey invite.

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