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

Gravity Forms Givebutter 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 Your Givebutter API Key
  3. Create the API key in Givebutter
  4. Save and test the connection
  5. Step 3: Create a Givebutter Feed
  6. Contact type and contact details
  7. Email-only forms: names to use when the form has none
  8. Address
  9. Tags and details
  10. How Contacts Are Matched and Updated
  11. Privacy and Consent
  12. Conditional Logic
  13. Developer Filter: gravityextra_givebutter_contact
  14. Checking Delivery on the Entry Screen
  15. Troubleshooting & FAQ
  16. A submission did not reach Givebutter. What happens?
  17. The note says Givebutter requires a first and last name.
  18. The connection fails or notes mention HTTP 401 or 403.
  19. The note says the Givebutter rate limit was reached.
  20. I see a supporter twice in Givebutter.
  21. Resource Hub

Every volunteer, event guest and newsletter subscriber who fills in a form on your website is a supporter you want to keep in touch with. The Gravity Forms Givebutter Premium Add-on sends those submissions to Givebutter as contacts, with name, email, phone, address, notes, email and SMS consent, custom fields and tags, so your team can follow up from the same place you run your campaigns.

This guide covers connecting your Givebutter API key, building a feed, how existing supporters are matched, and how to handle a submission that did not arrive.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.5 or higher
  • Givebutter account: An account admin who can create an API key (the Givebutter API is free to use)
  • GravityExtra license: The Givebutter 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 → Givebutter.
  3. Enter your license key in the Gravity Extra License section and save. The Givebutter API settings appear once the license is active.

Step 2: Connect Your Givebutter API Key

Create the API key in Givebutter

A Givebutter account admin creates the key under Settings → Integrations → API Keys (some accounts show it under Settings → Developers → API). Givebutter shows the key only once, so copy it straight into WordPress.

Save and test the connection

  • API Key (required): paste it and click Save Settings. It is stored in a masked password field and is never written to entry notes, logs or backup emails.
  • Connection: the add-on reads your campaign list to confirm the key works and shows “Connected to Givebutter — N campaigns.” The result is remembered for up to an hour; click Test connection to check again immediately.
  • Backup email for failed submissions: defaults to the site admin email. If Givebutter cannot be reached or rejects a contact, the contact details are emailed here so no supporter is lost. Leave it empty to turn it off.
Givebutter API settings in Gravity Forms showing a connected API key, Test connection button and backup email
Forms → Settings → Givebutter with a working API key and the Test connection button.

Step 3: Create a Givebutter Feed

Open your form, go to Settings → Givebutter and click Add New. The button is available once the API key is saved.

Contact type and contact details

Choose Individual (person) or Company / organization. Givebutter needs a first and last name for a person, or a company name for a company, so a company feed must map Company / Organization. Map First Name and Last Name, or a single Full Name field; a full name is split at the last space (“Mary Ann Lee” becomes Mary Ann / Lee). Map Email whenever the form collects it: it is used to find an existing contact so the same supporter is not added twice.

Givebutter feed contact mapping with feed name, contact type, name, email, phone and company fields
Contact mapping for a Volunteer Sign-Up form.

Email-only forms: names to use when the form has none

Newsletter and “Stay in Touch” forms often ask only for an email. Set First name when the form has none and Last name when the form has none (text or merge tags) so these contacts can still be created. If both are empty and the visitor gives no name, the submission is not sent and the entry gets a note explaining why.

Givebutter feed fallback first and last name for an email-only newsletter form
Fallback names on a Stay in Touch newsletter feed.

Existing supporters keep their real names

When the email already belongs to a Givebutter contact and the visitor did not type a name, the contact is matched and left as it is. The fallback names are only used for new contacts, so “Friend” never overwrites a donor’s real name. Tags are still added.

Address

Map the parts of a Gravity Forms Address field. US state names such as “Oregon” are converted to two-letter codes (OR), and country names to two-letter country codes. The address is sent when a new contact is created.

Givebutter feed address mapping from a Gravity Forms Address field
Address mapping from the Home Address field.

Tags and details

Tags is a comma-separated list (default “Website”) that accepts merge tags, for example {Volunteer Role:5} to tag each volunteer with the role they picked. Givebutter creates tags that do not exist yet. Each tag is limited to 64 characters and duplicates are removed. Map the visitor’s message to Notes / Message, pick your consent fields, and add Custom Fields by typing the custom field name exactly as it appears in Givebutter.

Givebutter feed Tags and Details section with merge tag tags, notes, email and SMS consent fields, custom fields and conditional logic
Tags with a merge tag, notes, consent fields, a T-Shirt Size custom field and conditional logic.

Custom fields have a safe fallback. If Givebutter does not accept the custom fields, the contact is saved again without them and the entry gets a warning note that lists the values, for example “T-Shirt Size: M”. Check the custom field names in the feed if you see this note.

How Contacts Are Matched and Updated

Before saving, the add-on looks up the email in Givebutter (primary or additional email, not case-sensitive). If a contact matches, it is updated; otherwise a new contact is created. If the lookup itself fails, nothing is created, so a temporary error cannot produce a duplicate.

Feed setting New contact Existing contact (matched by email)
First / Last Name, Employer, Job Title, Company Sent Updated when the visitor gave a name
Email, Phone Sent as primary email and phone Not changed
Address, Notes / Message Sent Not changed; existing contacts keep their note
Email / SMS Consent Field Subscribed when the field has a value Opted in when the field has a value
Custom Fields Sent Sent with the update
Tags Added after the contact is saved Added after the contact is saved
Contact Type Sent Never changed
Entry reference external_id = gf-[form ID]-[entry ID] Not changed

Contacts only, no donations

The add-on creates and updates contacts and adds tags. It does not record donations or transactions and does not add contacts to a campaign, so your fundraising totals in Givebutter are never affected by form submissions.

  • Email consent: map a consent or checkbox field to Email Consent Field. When the visitor ticks it, the contact is subscribed to email. When it is empty, the existing subscription is left unchanged, so an unticked box never unsubscribes anyone.
  • SMS consent: SMS Consent Field works the same way for text messages. Use a separate, unticked checkbox with clear wording such as “Text me shift reminders”.
  • Credentials: the API key is sent only in the request header and is removed from every note, log message and backup email.
  • Backup email contents: the backup email lists the contact fields, custom fields, tags, the error and a link to the entry. Send it to an inbox your team controls.

Conditional Logic

Tick Enable Condition to send only matching entries. Examples: send volunteers only when “Are You 16 or Older?” is Yes, send newsletter sign-ups only when the subscribe box is ticked, or create two feeds with different tags for “Food Pantry” and “Youth Mentor” roles.

Developer Filter: gravityextra_givebutter_contact

The gravityextra_givebutter_contact filter lets developers change the data before it is sent. It passes $data with the keys email, contact (new contact fields), update (fields for an existing contact; empty means no update), custom and tags, plus $feed, $entry and $form. Return the array. This example adds a yearly tag on form 3:

functions.php
PHP
// Add a yearly tag to everyone who signs up on form 3
add_filter( 'gravityextra_givebutter_contact', function( $data, $feed, $entry, $form ) {
    if ( (int) $form['id'] !== 3 ) {
        return $data;
    }
    $data['tags'][] = 'Volunteers ' . wp_date( 'Y' );
    return $data;
}, 10, 4 );

After a submission is fully sent, the gravityextra_givebutter_sent action fires with the saved contact ID, the feed, entry and form.

Checking Delivery on the Entry Screen

Entries from a form with an active Givebutter feed show a Givebutter box with the status (Sent to Givebutter, Not delivered or Not sent) and the Givebutter Contact ID. The entry notes say whether the contact was created, updated or matched by email, and which tags were added.

Givebutter status box showing Sent to Givebutter, the Givebutter contact ID and the Send again anyway button with its notice
A delivered entry: contact ID, notice and the Send again anyway button.

Saving a contact and adding its tags are two separate steps. If the tag step fails, the contact ID is kept and the box shows “Tags not added yet.” Clicking Send to Givebutter again retries only the tags, without creating a second contact.

Givebutter status box showing Not delivered, the saved contact ID, Tags not added yet and the Send to Givebutter again button
The contact was saved but the tags were not added yet.
Gravity Forms entry notes showing the failed tag step and the resumed send that added the tags without creating a second contact
Entry notes for the failed tag step and the resumed send.

Resending a delivered entry runs a full re-sync. Once an entry is Sent to Givebutter, the button changes to Send again anyway and asks you to confirm. Confirming looks the contact up by email again and updates it; if the email no longer matches a contact, a second contact may be created. Resending reruns every active Givebutter feed on the form whose conditions match, and is available to users who can edit entries.

Troubleshooting & FAQ

A submission did not reach Givebutter. What happens?

The entry is kept, the status becomes Not delivered, a note records the reason (for example “Givebutter did not accept the contact: …”), and the backup email “Givebutter contact not delivered — [form name]” is sent with the contact details. Fix the cause, open the entry and click Send to Givebutter again.

The note says Givebutter requires a first and last name.

The visitor gave no name and the feed has no fallback names. Map the name fields, or fill in First name when the form has none and Last name when the form has none, then resend the entry. Company feeds need the Company / Organization field instead.

The connection fails or notes mention HTTP 401 or 403.

Givebutter rejected the API key. Create a new key in Givebutter, paste it into Forms → Settings → Givebutter, save, click Test connection and resend the affected entries.

The note says the Givebutter rate limit was reached.

Givebutter allows 500 requests per minute. The note says how many seconds to wait; resend the entry after that. Each submission uses up to three requests: the email lookup, the save and the tags.

I see a supporter twice in Givebutter.

Matching uses the email address. Make the Email field required and map it in the feed; forms without an email always create a new contact. A note about the GravityExtra license means sending is 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