Documentation

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

The first step to automating your workflows is to establish a secure connection with authentication between your website and your n8n instance. This guide will walk you through creating your first connection profile.

A connection profile stores the authentication details for a specific n8n instance, allowing you to reuse it across multiple forms and feeds easily.

Step 1: Navigate to the n8n Connector Settings

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

  1. From your WordPress admin dashboard, hover over Forms in the left-hand menu.
  2. Click on Settings.
  3. Select the n8n Connector tab.

This will take you to the main screen where you can manage all your n8n connections.

Step 2: Add a New n8n Connection

On the n8n Connector settings page, you’ll see a list of your existing connections (if any).

Click the “Add New” button to open the form for creating a new connection.

Step 3: Configure Your 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 name to help you identify this connection later. For example, “My Production n8n” or “Client X n8n Instance”.
  • Slug: A unique, URL-friendly identifier for this connection. It cannot be changed later. Good examples are production-n8n or client-x. This slug is used internally and as the Key ID (kid) in the JWT header for authentication.
  • Webhook URL: The base URL of your n8n instance. This should be the main URL, without any specific webhook paths. For example: https://n8n.mycompany.com.
  • Algorithm: The hashing algorithm used for the JWT signature. HS256 is the most common and is a good default choice unless you have a specific reason to use another.
  • Secret Token: This is the secret key that n8n will use to verify the authenticity of the requests it receives from Gravity Forms.

Now copy the secret token for step 4. Now you can save your connection.

Step 4: Create a new JWT Auth Credential on 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.

  1. Log in to your n8n instance.
  2. From the main n8n menu, navigate to the Credentials section.
  3. Click the “Add credential” button.
  4. In the search bar, type JWT and select “JWT Auth” from the list of available credential types.
  5. This will open the credential configuration form. You only need to fill in two fields:
    • Credential Name: Give it a memorable name that links it to your website, like “Gravity Forms JWT” or “My Website Auth”.
    • Secret: This is the most important part. Copy the exact same Secret Token that you generated or entered in your GravityWP n8n Connector settings in WordPress and paste it here.
  6. Leave all other fields (like “Auth Header Name” and “Auth Header Value Prefix”) as their default values.
  7. Click the “Save” button to create the credential.

This credential is now saved and can be selected in any n8n Webhook node as method of authentication.

Next Steps

Congratulations! You have successfully set up the authentication between Gravity Forms and your n8n instance. Now you are ready to start automating.

n8n Connector1.0

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

Read more