← Help & Support

Connect Gravity Forms

Connect your Gravity Forms site to Data Curator so your form submissions — and any payments taken through your forms — flow into your dashboards. Gravity Forms connects with two credentials you create inside your own WordPress admin: a Consumer Key and a Consumer Secret.

Before you start

• You'll need a Data Curator account with owner/admin access to your organization.
• You'll need administrator access to the WordPress site running Gravity Forms.
• Your site must be on HTTPS and running Gravity Forms 2.4 or newer (the REST API ships with Gravity Forms itself — there's no add-on to buy).

Turn on the Gravity Forms REST API

1. In WordPress, go to Forms → Settings, then open the REST API tab.
2. Tick Enabled, then click Update.

Create your API key

1. Still on the REST API tab, under Authentication, click Add Key.
2. Fill in:
   • Description — call it Data Curator so you recognize it later.
   • User — pick an administrator account. The key inherits that user's permissions, and it needs to be able to view forms and entries.
   • Permissions — choose Read. That's all Data Curator needs; it never writes to your site.
3. Click Add Key. Your Consumer Key and Consumer Secret appear once, in a box on screen.
4. Copy both values now. WordPress won't show the secret again. If you lose it, just delete the key and create a new one.
5. Scroll to the bottom of the page and click Update. This step is easy to miss and it matters: your key is saved but stays inactive until you click Update. A key that hasn't been activated looks exactly like a wrong key — it returns a "rejected" error when you test it.

Finish in Data Curator

1. In Data Curator, open Settings → Platform Accounts (the gear icon in the top-right, then Platform Accounts).
2. Click Connect platform account, then choose Gravity Forms.
3. Fill in:
   • WordPress Site URL — your site's home address and nothing more, like https://yoursite.com. Leave off any path (no /blog, no /wp-json).
   • Consumer Key and Consumer Secret — the two values you just copied.
   • Account Name — a short label for this site, letters, numbers and dashes only (for example yoursite). If you connect more than one site, or you already connect another platform, give each one a different name.
4. Click Test Scopes. Data Curator calls your site once to confirm the key works.
5. Click save and connect.
6. Your import starts automatically: your full contact list from every form submission, plus form submissions and any form payments from your organization's import start date onward.

If the test fails

• "Gravity Forms rejected the API key" — nine times out of ten this is the Update button in step 5 above. Go back to Forms → Settings → REST API and click Update at the bottom, then test again. Otherwise, check the key has Read permission and that the WordPress user it belongs to can view entries.
• "Gravity Forms REST API wasn't found" — the REST API tab isn't enabled, or the site address is off. Confirm Enabled is ticked, and that you entered your site's home address with no extra path.
• "must use https://" — Data Curator only connects over a secure connection, because your Consumer Secret travels with every request. If your site isn't on HTTPS yet, your host can usually enable it for free.
• Site address rejected — enter the public address of your site. Internal or local addresses (anything on your private network) are refused on purpose.

Good to know

• Spam and trashed entries are skipped. Only live entries become contacts, so a spam-heavy form won't pollute your lists.
• Payments taken through your forms are matched up with the charge already in your Stripe or PayPal data, so a form sale shows the right product and price instead of an unlabeled payment.
• Data Curator polls your site on a schedule. Real-time delivery needs the Gravity Forms Webhooks add-on (an Elite licence feature) and isn't part of this connection yet.

Need a hand?

Click the Ask Data Curator button inside Data Curator for instant answers, or reach our support team at support@datacurator.co and we'll get you running.