/ Example — Contact Form 7

CF7 to Webhook: Send Contact Form 7 Data to n8n (Step-by-Step)

Setting up a CF7 to webhook integration isn't built into Contact Form 7. To send form submissions to tools like n8n you need custom code or an additional plugin. This guide covers both approaches — the quick way and the reliable way.

TL;DR

  • The basic CF7 webhook uses wpcf7_mail_sent + wp_remote_post — works for low-volume forms but has no retry, no logging, and silently drops failures
  • Access submitted field values via $submission->get_posted_data()['field-name'] from the WPCF7_ContactForm submission object
  • For production: add persistent storage and retry logic so no CF7 submission is lost when the receiving endpoint is temporarily down
/ Basic Method

Basic CF7 to Webhook Using wp_remote_post

The most common approach to a CF7 to webhook integration uses the wpcf7_mail_sent action hook. Contact Form 7 fires this hook after a successful submission — you hook into it, grab the submitted data, and POST it to your webhook endpoint.

Here's the minimal working code. Add it to your theme's functions.php or a custom plugin:

functions.php — cf7 to webhook (basic)
add_action('wpcf7_mail_sent', function ($contactForm) { $submission = WPCF7_Submission::get_instance(); if (!$submission) { return; } $data = $submission->get_posted_data(); wp_remote_post('https://your-n8n-url/webhook/test', [ 'headers' => [ 'Content-Type' => 'application/json', ], 'body' => json_encode($data), ]); });

This works. It's simple and widely used. For a hobby project or an internal form with low submission volume, it does the job.

The problem is what happens in production.

/ Production Reality

Why the Basic CF7 to Webhook Setup Breaks in Production

The wp_remote_post() approach works in development. The problem shows up once your CF7 to webhook integration is handling real traffic: the call is synchronous, so PHP blocks and waits for the remote server to respond before the form submission completes.

Contact Form 7 has over 10 million active installations on WordPress.org — making it one of the most-deployed plugins in the ecosystem. At that scale, silent webhook failure is not an edge case; it accumulates across every site relying on synchronous wp_remote_post() without retry logic.

Form submissions can fail silently if the receiving service is down. Without retries, that means lost leads — and no way to know it happened until someone complains.

/ Better Approach

Reliable Method: Queue-Based Webhooks with Retry and Logging

This example uses Webhook Actions by Flow Systems — a free WordPress plugin that provides reliable webhook delivery with automatic retry and replay support.

It works by queuing webhook dispatch as a background job, so your form submissions are never blocked by a slow or unavailable endpoint.

A reliable CF7 to webhook setup separates two things the basic approach conflates: recording that a submission happened and delivering it to the endpoint.

When a CF7 form is submitted, a background job is queued immediately. The user gets an instant response — the form submission is complete from their perspective. A cron worker then picks up the job and attempts delivery in the background.

If the delivery fails — because n8n returned a 5xx, hit a rate limit (429), or simply timed out — the job is scheduled for retry with exponential backoff: 1 min, 2 min, 4 min, 8 min, 16 min. Each attempt is logged with the HTTP status code and response body. You can see every success and failure in the WordPress admin.

If all retry attempts are exhausted, the job enters a failed state — visible in the event log, and replayable via the REST API or the admin UI. No data is lost.

/ Setup

Step-by-Step: CF7 to Webhook Setup
with Retry and Logging

  1. 1
    Install the plugin

    Search for this exact description in Plugins → Add Plugin — it narrows the WordPress.org search to exactly one result:

    search text — paste into WordPress plugin search
    FlowSystems
  2. 2
    Create a new webhook

    Go to Webhooks → Add Webhook in the WordPress admin. Give it a name (e.g., "CF7 → n8n").

  3. 3
    Select the trigger

    Set the WordPress action hook to wpcf7_mail_sent. This fires once per successful CF7 form submission.

    action hook — paste into the trigger field
    wpcf7_mail_sent
    Webhook Actions by Flow Systems admin — selecting the wpcf7_mail_sent trigger hook from Contact Form 7 to fire a webhook on form submission
    Webhook Actions admin — searching “sent” and selecting the wpcf7_mail_sent hook under Contact Form 7
  4. 4
    Set the webhook URL

    Paste your n8n webhook URL (e.g., https://your-n8n-url/webhook/test). The plugin will POST form data to this endpoint on every submission.

  5. 5
    Save and test

    Submit your Contact Form 7 form. Check the Event Log in the plugin admin to see the delivery status and the payload that was sent.

    Webhook Actions by Flow Systems event log showing a pending webhook delivery for a Contact Form 7 submission triggered by the wpcf7_mail_sent hook
    Webhook Actions by Flow Systems event log — Contact Form 7 submission queued via wpcf7_mail_sent, delivery status pending
/ n8n

Setting Up the n8n Webhook

On the n8n side, you need a Webhook node configured to receive POST requests:

  1. 1
    Add a Webhook node

    In your n8n workflow, add a new node and search for "Webhook".

  2. 2
    Set HTTP Method to POST

    The plugin sends a JSON POST request, so make sure the Webhook node is set to accept POST.

  3. 3
    Copy the webhook URL

    n8n will generate a URL like https://your-n8n-url/webhook/test. Copy this and paste it into the plugin's webhook URL field (step 4 above).

    n8n Webhook node configuration showing the webhook URL to copy and paste into Webhook Actions by Flow Systems for Contact Form 7 integration
    n8n Webhook node — copy the webhook URL and paste it into the Webhook Actions by Flow Systems plugin to receive CF7 form submissions
  4. 4
    Activate and test

    Click "Listen for test event" in n8n, then submit your CF7 form. n8n will display the incoming payload so you can map the fields to subsequent nodes.

    Full walkthrough — CF7 form submission triggers a webhook payload delivered to n8n via Webhook Actions by Flow Systems
/ Payload

Example Payload

Here's what a typical CF7 submission looks like when it arrives at your n8n webhook. The field names match the name attributes you set in your CF7 form tags.

POST body — application/json
{ "event": { "id": "085cc108-654f-4b26-b39e-921cc8208bbd", "timestamp": "2026-03-23T12:59:21Z", "version": "1.0" }, "hook": "wpcf7_mail_sent", "args": [ { "__type": "WPCF7_ContactForm", "id": 16, "title": "Contact form 1", "name": "contact-form-1", "locale": "en_US", "submission": { "fields": { "your-name": "Mateusz", "your-email": "[email protected]", "your-subject": "CF7 to webhook test", "your-message": "Testing integration" }, "meta": { "url": "https://webhook-actions.local/cf-7-example/", "timestamp": 1774270761, "remote_ip": "172.22.0.1", "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36", "container_post_id": 17, "current_user_id": 0 } } } ], "timestamp": 1774270761, "site": { "url": "https://webhook-actions.local" } }

The payload wraps the full WPCF7_ContactForm object including submitted fields, page url, remote_ip, and user_agent. Use args[0].submission.fields in n8n to access form values directly.

/ Advanced

Advanced: Retry and Debug Failed Submissions via API

Every webhook delivery attempt is stored in the event log — success or failure. If a CF7 submission didn't reach n8n, you can replay it without asking the user to resubmit.

The plugin exposes a REST API for this:

retry a failed delivery
POST /wp-json/fswa/v1/logs/{id}/retry // Response { "success": true, "message": "Retry queued" }

Replace {id} with the log entry ID visible in the Event Log. This re-queues the exact payload that was originally sent — no need to reconstruct it.

You can also trigger retries from the WordPress admin UI. Both options are covered in the REST API documentation.

Webhook Actions by Flow Systems event log showing a failed CF7 webhook delivery with a retry action button to re-send the Contact Form 7 submission
Webhook Actions event log — failed CF7 webhook delivery with a retry action to re-queue the submission without asking the user to resubmit
/ Real-World Reliability

Why Your CF7 to Webhook Integration
Needs Retry Support

A contact form submission is often a high-intent signal — someone typing their email and pressing send is more committed than a page view. Losing that data silently is costly.

With a bare wp_remote_post() call, any of these common scenarios causes permanent data loss:

n8n restarts during deployment. Your instance hits a memory limit and returns 500. The incoming webhook URL changes and the old one starts returning 404. A rate limit is hit during a campaign burst.

None of these are edge cases in real production environments. A queue with retries means these scenarios become recoverable failures instead of silent data loss. The event log means you can diagnose and replay — instead of guessing.

Exponential backoff is the industry-standard approach for retryable HTTP operations. AWS documentation on error retries and exponential backoff explains that spacing retries progressively further apart — rather than at fixed intervals — reduces load on a recovering service and improves overall delivery success rates for transient failures.

Without retries, a single n8n restart during business hours can mean lost leads. With retry and replay support, the same event becomes a recoverable blip — automatically resolved within minutes.

/ FAQ

Common questions

To connect CF7 to a webhook, hook into the wpcf7_mail_sent action and use wp_remote_post() to send submitted data to your endpoint. For production use, a queue-based plugin like Webhook Actions by Flow Systems gives you automatic retries, delivery logging, and replay — so no form submission is ever lost silently. See the full code and step-by-step setup above.
Not natively. CF7 doesn't include a webhook feature out of the box. To send form data to a webhook endpoint you need custom code using the wpcf7_mail_sent action hook, or a plugin that handles webhook dispatch for you.
Hook into the wpcf7_mail_sent action, retrieve submitted data via WPCF7_Submission::get_instance(), and post it to your n8n webhook URL using wp_remote_post(). For reliable delivery with retries, use a queue-based plugin like Webhook Actions by Flow Systems that handles failures automatically.
With a bare wp_remote_post() call, the data is lost silently — there's no retry and no log entry. With a queue-based system, the failed delivery is stored and retried automatically with exponential backoff (1 min → 2 min → 4 min → 8 min → 16 min). You can also replay any failed submission manually from the WordPress admin.
Yes, if you use a plugin with retry support. Webhook Actions by Flow Systems retries failed deliveries automatically and also exposes a REST API endpoint (POST /wp-json/fswa/v1/logs/{id}/retry) that lets you replay any past submission — including successful ones.
Yes. wp_remote_post() is synchronous — PHP blocks and waits for the remote server to respond before the form submission completes. If your n8n instance is slow or unavailable, users experience a delayed or failed form submission. A queue-based approach dispatches the webhook in the background so the user sees an instant response regardless of endpoint latency.