Gravity Forms icon

Gravity Forms

Interact with Gravity Forms REST API v2

Actions10

Overview

The node integrates with the Gravity Forms REST API v2, enabling users to interact programmatically with forms and entries managed by Gravity Forms. Specifically, the Tool - Find Entries operation allows performing a full-text search across form entries, returning matching results limited by a user-defined count.

This operation is useful when you want to quickly locate specific form submissions based on keywords or phrases contained within entry content. For example, you might use it to find all entries mentioning a particular product name or customer feedback keyword without manually browsing through all entries.

Practical scenarios include:

  • Searching for support requests containing certain error codes.
  • Finding survey responses that mention a specific topic.
  • Quickly retrieving recent entries related to a marketing campaign.

Properties

Name Meaning
Limit The maximum number of entries to return. Must be between 1 and 100.
Search Term A full-text search string executed against the content of entries. If empty, returns entries without filtering by text.

Output

The output is an array of JSON objects, each representing a Gravity Forms entry matching the search criteria. Each entry object contains all standard fields returned by the Gravity Forms API for an entry, such as entry ID, form ID, field values, timestamps, and status.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "id": 123,
    "form_id": 5,
    "date_created": "2023-01-01T12:00:00Z",
    "fields": {
      "1": "John Doe",
      "2": "john@example.com",
      "3": "Feedback about product X"
    },
    "status": "active"
  },
  ...
]

Dependencies

  • Requires a valid API authentication token/credential configured in n8n to access the Gravity Forms REST API.
  • The node depends on the Gravity Forms REST API v2 endpoint being accessible.
  • No additional external services are required beyond the Gravity Forms API.

Troubleshooting

  • Empty or no results returned:
    Ensure the search term is correctly specified and matches existing entry content. Also verify that the API credentials have permission to read entries.

  • Invalid JSON errors:
    This operation does not require JSON input from the user except for the search term and limit, so invalid JSON errors are unlikely here.

  • API request failures:
    Common causes include incorrect API credentials, network issues, or the Gravity Forms API being down. Check your API key configuration and network connectivity.

  • Limit out of range:
    The limit must be between 1 and 100. Setting a value outside this range will cause an error.

Links and References

Discussion