Title: Gragrid: Gravity Forms + SendGrid
Author: Vlass Contreras
Published: <strong>September 15, 2020</strong>
Last modified: June 11, 2022

---

Search plugins

![](https://ps.w.org/gragrid/assets/banner-772x250.png?rev=2483129)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/gragrid/assets/icon.svg?rev=2483129)

# Gragrid: Gravity Forms + SendGrid

 By [Vlass Contreras](https://profiles.wordpress.org/vlass/)

[Download](https://downloads.wordpress.org/plugin/gragrid.2.2.2.zip)

 * [Details](https://test.wordpress.org/plugins/gragrid/#description)
 * [Reviews](https://test.wordpress.org/plugins/gragrid/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/gragrid/#installation)
 * [Development](https://test.wordpress.org/plugins/gragrid/#developers)

 [Support](https://wordpress.org/support/plugin/gragrid/)

## Description

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.

## Screenshots

 * [[
 * Plugin settings page
 * [[
 * Multiple feeds, send submissions to multiple lists
 * [[
 * Feed settings page

## 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

## 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](https://docs.gravityforms.com/email/)
   or [Hidden](https://docs.gravityforms.com/hidden/).
 * To map the **First Name** and **Last Name** you need to have a field of type 
   [Name](https://docs.gravityforms.com/name/), [Text](https://docs.gravityforms.com/text-field/),
   or [Hidden](https://docs.gravityforms.com/hidden/)
 * To map the **Address** you need to have a field of type [Address](https://docs.gravityforms.com/address-field/),
   [Text](https://docs.gravityforms.com/text-field/), or [Hidden](https://docs.gravityforms.com/hidden/)

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

The field dropdowns show the [Field Label](https://docs.gravityforms.com/common-field-settings/#field-label)
or [Admin Field Label](https://docs.gravityforms.com/common-field-settings/#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.

## Reviews

![](https://secure.gravatar.com/avatar/2bee0f27a9a8b36c17d8e9b5b67201d72de775a90b6ef57d5688cee11f07fdda?
s=60&d=retro&r=g)

### 󠀁[Amazing](https://wordpress.org/support/topic/amazing-3027/)󠁿

 [kevinfbs](https://profiles.wordpress.org/kevinfbs/) March 15, 2021 1 reply

This plugin is amazing and works exactly as described and integrates perfectly with
SendGrid. This plugin saved many hours of customization coding and tons of lines
of codes to achieve these results. The author is extremely talented and follows 
up with all support and has even made 2 huge upgrades based on feedback in past 
couple of weeks. Highly recommend.

 [ Read all 1 review ](https://wordpress.org/support/plugin/gragrid/reviews/)

## Contributors & Developers

“Gragrid: Gravity Forms + SendGrid” is open source software. The following people
have contributed to this plugin.

Contributors

 *   [ Vlass Contreras ](https://profiles.wordpress.org/vlass/)

“Gragrid: Gravity Forms + SendGrid” has been translated into 1 locale. Thank you
to [the translators](https://translate.wordpress.org/projects/wp-plugins/gragrid/contributors)
for their contributions.

[Translate “Gragrid: Gravity Forms + SendGrid” into your language.](https://translate.wordpress.org/projects/wp-plugins/gragrid)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/gragrid/), check out
the [SVN repository](https://plugins.svn.wordpress.org/gragrid/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/gragrid/) by [RSS](https://plugins.trac.wordpress.org/log/gragrid/?limit=100&mode=stop_on_copy&format=rss).

## 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](https://github.com/vlasscontreras/gragrid/issues/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](https://github.com/vlasscontreras/gragrid/issues/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

## Meta

 *  Version **2.2.2**
 *  Last updated **4 years ago**
 *  Active installations **100+**
 *  WordPress version ** 5.2 or higher **
 *  Tested up to **6.0.11**
 *  PHP version ** 7.3 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/gragrid/) and [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/gragrid/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/gragrid)
 * Tags
 * [emails](https://test.wordpress.org/plugins/tags/emails/)[forms](https://test.wordpress.org/plugins/tags/forms/)
   [gravity forms](https://test.wordpress.org/plugins/tags/gravity-forms/)[sendgrid](https://test.wordpress.org/plugins/tags/sendgrid/)
   [subscribers](https://test.wordpress.org/plugins/tags/subscribers/)
 *  [Advanced View](https://test.wordpress.org/plugins/gragrid/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/gragrid/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/gragrid/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/gragrid/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/gragrid/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/gragrid/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/gragrid/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/gragrid/reviews/)

## Contributors

 *   [ Vlass Contreras ](https://profiles.wordpress.org/vlass/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/gragrid/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://github.com/vlasscontreras/gragrid)