Gragrid: Gravity Forms + SendGrid

June 11, 2022

Gragrid: Gravity Forms + SendGrid Plugin

Integrates Gravity Forms with SendGrid, allowing form submissions to be automatically sent to your SendGrid contact lists.

Integrate your Gravity Forms with SendGrid to send submissions with email fields to your contact lists.

Advanced

You can customize the contact data sent to SendGrid in the entry submission context with this hook:

apply_filters( 'gragrid_contact_params', array $contact_params, array $entry, array $form ) 
  • $contact_params (array): Contact parameters, includes first name, email, custom fields, etc.
  • $entry (array): The form entry that was just created.
  • $form (array): The current form, the origin of the submission.

You can also customize the SendGrid API requests using the following hook:

apply_filters( 'gragrid_request_args', array $args, string $path ) 
  • $args (array): Request arguments, includes headers, method, body, etc.
  • $path (string): The specific API endpoint being called.

Installation

  1. Upload the extracted contents of gravity-forms-sengrid.zip to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to Forms > Settings > SendGrid and add your API key

Screenshots

  1. Plugin settings page

    Plugin settings page

  2. Multiple feeds, send submissions to multiple lists

    Multiple feeds, send submissions to multiple lists

  3. Feed settings page

    Feed settings page

FAQ

Why can’t I create a feed?

Make sure you have set a valid API key in the global SendGrid settings by going to Forms > Settings > SendGrid. There should be a green checkmark next to the API key field if the API key is valid.

What permissions do I need to select when creating an API key?

This plugin only requires full access to Marketing > Marketing.

Why the field dropdowns in the mapping settings are empty?

  • To map the Email you need to have a field of type Email or Hidden.
  • To map the First Name and Last Name you need to have a field of type Name, Text, or Hidden
  • To map the Address you need to have a field of type Address, Text, or Hidden

The field dropdown options in the mapping settings are blank but selectable, what’s going on?

The field dropdowns show the Field Label or Admin Field Label, so make sure you have either of those set up in your fields. Or both, it’s also a good practice for accessibility!

Why I don’t see any custom fields in the form settings?

The custom field mapping won’t appear unless you have at least 1 custom field in your SendGrid account, so make sure you have at least one.

Can this plugin be installed at the same time as the official SendGrid Gravity Forms add-on?

Yes. The official add-on and this plugin have different purposes and do not have conflicts in between.

Can this plugin be installed at the same time as the official SendGrid WordPress plugin?

Yes. Just like Gravity Forms’ SendGrid add-on, this plugin serves a different purpose and does not conflict with it.

Changelog

2.2.2

  • Fixes the truncated contact lists on the feed settings page
  • Tested on WordPress 6.0

2.2.1

  • Handles fatal error on the feed listing when the API key is invalid
  • Escape HTML in translation strings
  • Tested on WordPress 5.8

2.2.0

  • Fixes fatal error due to unitialized API class on Gravity Forms 2.5+ [#15]
  • Adds error feedback when contact lists cannot be retrieved on the feed settings

2.1.0

  • Adds support to map more reserved/default SendGrid fields
  • Adds support to map custom fields 🥳
  • Introduces a new filter hook gragrid_contact_params to filter contact data at entry context

2.0.0

  • Uses Twilio SendGrid’s new Marketing Campaigns API (see #9)
  • Adds address fields to map them to SendGrid Contacts
  • New logo 💅🏻

1.1.0

  • Adds support for conditional feeds
  • Adds notes to form entries when the feeds are processed

1.0.0

  • Initial release

Details

  • Version: 2.2.2
  • Active installations: 200
  • WordPress Version: 5.2
  • Tested up to: 6.0.9
  • PHP Version: 7.3

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars