How can we help you?

1. Overview & System Requirements

The Gravity Forms Resend Integration provides modern web applications, agencies, and enterprise organizations with a developer-first transactional email delivery pipeline powered by the Resend REST API. Traditional WordPress email sending relies on PHP mail or cumbersome SMTP configurations that frequently suffer from delivery delays, shared server IP blacklisting, spam folder filtering, and silent transmission drops. This integration replaces obsolete email transport mechanisms with high-speed direct REST API delivery to ensure 100% email deliverability for mission-critical notifications, user confirmations, customer receipts, and urgent alerts.

By connecting Gravity Forms notifications directly to Resend, every form submission dispatches an encrypted HTTPS API request that bypasses standard mail ports (25, 465, 587) often throttled or blocked by managed WordPress hosts. In addition to lightning-fast throughput, users gain access to real-time delivery telemetry, bounce tracking, click-through metrics, and custom sender domain verification.

2. Authentication & API Key Connection

The integration uses secure Bearer Token authentication to communicate with the Resend API (api.resend.com/emails). Follow these setup steps:

Step-by-Step API Key Setup

1. Log in to your Resend Dashboard at resend.com/overview.
2. Navigate to the API Keys section in the left navigation sidebar.
3. Click Create API Key, assign a recognizable name (e.g., Production Gravity Forms), select Full Access or Sending Access permissions, and choose your verified sending domain.
4. Copy the secret key string (which begins with the prefix re_).
5. In your WordPress admin dashboard, navigate to Forms → Settings → Resend.
6. Paste your Resend API Key into the API Key input field and specify your default verified sender address (e.g., notifications@yourdomain.com).
7. Click Save Settings. The add-on immediately issues a live test ping against Resend. A green verification indicator confirms that authentication is active.

3. Feed Configuration & Email Customization

Once authenticated, you can configure dedicated Resend notification feeds on any form or globally route all standard Gravity Forms notifications through Resend.

Configuring a Resend Notification Feed

• Sender Information (From Name & Email): Configure your branded sender name and verified sending domain email address. The domain must match an active verified domain in Resend.
• Recipient Mapping (To, CC, BCC): Map recipient addresses to specific form fields (such as user email inputs) or hardcode administrative distribution lists. Multiple email addresses can be separated by commas.
• Subject Line & Merge Tags: Craft dynamic email subject lines incorporating Gravity Forms merge tags like New Intake Request from {Name (First):1.3} {Name (Last):1.6} [ID: #{entry_id}].
• Email Body Formatting: Choose between clean raw text, standard Gravity Forms HTML tables (using {all_fields}), or custom responsive HTML layouts.
• Reply-To Header Routing: Map user-submitted email inputs directly to the Reply-To header, allowing team members to hit Reply in their email client and communicate directly with the form submitter.
• Attachment Handling: Automatically attach uploaded files (such as resume PDFs, image screenshots, or signed agreements) directly into the Resend email payload as Base64-encoded MIME attachments.

4. Advanced Delivery Automations & Tracking

Resend offers enterprise email infrastructure features that elevate your form messaging:

• Email Tagging & Analytics: Assign custom metadata tags (e.g. category: sales-lead, form_id: 14) to every outgoing dispatch. This enables granular segmentation and reporting in your Resend analytics console.
• Conditional Notification Routing: Use Gravity Forms conditional logic on the feed to send different confirmation emails based on user choices (e.g., sending an instant booking confirmation for VIP clients while routing standard inquiries to a queue).
• Asynchronous Background Dispatch: Leverage WordPress Action Scheduler to offload email transmission to a background worker process, ensuring form submissions complete instantly without waiting for network latency.
• Webhook Delivery Verification: Pair with Resend Webhooks to listen for email delivery, bounce, or complaint events, automatically logging delivery confirmations inside Gravity Forms entry notes.

5. Error Handling & Troubleshooting Matrix

Use the following reference matrix to identify and resolve Resend API response errors:

6. Developer Extensibility & Filter Hooks

Developers can programmatically modify email headers, inject custom tracking tags, or alter HTML payloads prior to transmission:

/**
 * Filter: gform_resend_email_payload
 * Purpose: Customize outgoing Resend API email payload.
 * 
 * @param array $payload The structured JSON payload sent to Resend.
 * @param array $form    The Gravity Forms form object.
 * @param array $entry   The submitted entry object.
 * @param array $feed    The Resend feed settings.
 * @return array Modified payload array.
 */
add_filter( 'gform_resend_email_payload', function( $payload, $form, $entry, $feed ) {
    // Append tracking tags for analytical attribution
    $payload['tags'][] = [
        'name'  => 'form_id',
        'value' => (string) $form['id'],
    ];
    $payload['tags'][] = [
        'name'  => 'environment',
        'value' => wp_get_environment_type(),
    ];
    
    // Add custom security headers
    $payload['headers']['X-Entity-Ref-ID'] = 'GF-ENTRY-' . $entry['id'];
    
    return $payload;
}, 10, 4 );

/**
 * Action: gform_resend_post_send
 * Purpose: Record the unique Resend Email ID in entry metadata.
 */
add_action( 'gform_resend_post_send', function( $response, $entry, $form ) {
    $email_id = rgar( $response, 'id' );
    if ( ! empty( $email_id ) ) {
        gform_update_meta( $entry['id'], 'resend_email_id', sanitize_text_field( $email_id ) );
    }
}, 10, 3 );

7. Frequently Asked Questions