Documentation

Getting Started: How to Set Up Your First Connection between n8n and Gravity Forms

The first step to automating with n8n is establishing a secure, authenticated connection between your WordPress site (Gravity Forms) and your n8n instance. This guide walks you through creating a reusable connection profile and the matching JWT credential in n8n.

A connection profile stores the base URL, JWT algorithm, and secret used to sign requests from Gravity Forms to n8n. You can reuse this connection across multiple forms and feeds.


Prerequisites for your n8n Gravity Forms connection


Step 1: Open the n8n Connector settings in WordPress

First, you need to go to the central settings page for the n8n Connector.

  1. In your WordPress dashboard, go to Forms → Settings.
  2. Click the n8n Connector tab.

    You’ll land on the page where all n8n connections are managed.

Step 2: Add a new n8n Gravity Forms connection

Click Add New to create a connection profile.


Step 3: Configure your n8n Gravity Forms connection details

Now it’s time to fill in the details for your n8n instance. Each field is important for establishing a secure and reliable link.

  • n8n Name – A friendly label (e.g., “Production n8n” or “Client X n8n”).
  • Slug – A permanent, URL-friendly ID (e.g., production-n8n).
    • Important: The slug can’t be changed later and is used as the JWT kid (Key ID) in the token header. Pick something stable.
  • Webhook URL – The base URL of your n8n instance (no webhook path). Example: https://n8n.example.com
  • Algorithm – The JWT signing algorithm. HS256 is the recommended default.
  • Secret TokenAuto-generated by the GravityWP n8n Connector when you create the connection.
    • Click Copy to use this exact value in n8n (next step). Keep it secure.

Click Save to create the connection.


Step 4: Create the matching JWT credential in n8n

Now that you have your Secret Token from the Gravity Forms plugin, you need to create a corresponding credential inside your n8n instance. This tells n8n how to verify that incoming requests from your forms are authentic and secure.

  • In n8n, open the button next to Create Workflow and choose Create Credential.
n8n Gravity Forms connection setup – n8n menu showing Create Credential option beside Create Workflow.
Use this dropdown in n8n to create the credential required for your n8n Gravity Forms connection.
  • In the credential type list, search for JWT and select JWT Auth.
  • Configure the credential:
n8n Gravity Forms connection credential setup – JWT Auth form with Passphrase, Secret Token, and HS256 algorithm.
Example of a JWT Auth credential in n8n with HS256 algorithm and secret token for your n8n Gravity Forms connection.
  • Credential Name – Something memorable (e.g., “Gravity Forms JWT”).
  • Key TypePassphrase.
  • SecretPaste the exact Secret Token from your GravityWP n8n connection.
  • AlgorithmHS256 (must match the WordPress connection).

Note: You will not see fields like “Auth Header Name” or “Auth Header Value Prefix” here. That’s expected the JWT Auth credential plus the Webhook node handle the authentication automatically.

What you’ve accomplished with your n8n Gravity Forms connection

  • WordPress and n8n now share a verified JWT setup (same secret + algorithm).
  • The connection profile is reusable across forms and feeds.

Next steps: Set up the feed to send Gravity Forms submissions to a n8n workflow. This guide shows you how to connect your form to a specific n8n Webhook and (optionally) map the response back into the entry.

Last updated: 01-10-2025

n8n Connector1.0

For this functionality to work you need to install the GravityWP - n8n Connector Add-on.

Read more