Wufoo's API, Webhooks, and URL Structure

Wufoo has a REST API and supports webhooks.

To find your API key, form's hash, or field API IDs, just open the API information for your form:

  1. Log in and go to Forms.
  2. To the right of the form, hover over More and click API Information.
  3. Copy your API Key, or look at the table to find your form's hash or field API IDs.
TIP! Check out our API documentation.

API Keys

To use the API, you'll need your API key, which you can find following the steps at the top of this page. This key acts as a password to your data, so be sure to keep it private!

To reset your API key, open your API key and click Reset. Any applications using your key will recieve an authentication error once you reset your key. You'll need to incorporate your new key into the code for them to continue working.

Form Hashes

Each entity you interact with in Wufoo (forms, reports, widgets, users, etc.) has a friendly URL and a hashed URL. A friendly URL is easy to read and remember, but changes based on the form title. A hashed URL is less memorable, but doesn't change when the form title changes.

While you can use a friendly URL in your API calls, if your form titles changes it'll break the code. We recommend the hashed URL since a form's hash will always stay the same.

Field API IDs

Field API IDs uniquely identify each field on your form. They are used in many API calls. You can find the API ID for each field following the steps at the top of this page.

Field IDs can be used when templating or with URL modifications to create a link to send a form with custom values already filled into fields.


If you're running up against your API request limit, webhooks may be a solution. Learn more about creating webhooks with the Wufoo API.

To set up your form so it sends field metadata to your webhooks:

  1. Log in and go to Forms.
  2. To the right of the form, hover over Edit and click Add Notifications.
  3. Click the dropdown menu and choose WebHook.
  4. Click Add Integration.
  5. Enter your WebHook URL—the URL where Wufoo should send the HTTP POST.
  6. Enter your WebHook Handshake Key (optional).
  7. Select Include Field and Form Structures with Entry Data if you'd like the POST request to include metadata about your form’s fields.
  8. Click Save.
How to find your API keys, form hashes, and field IDs or set a form to send field metadata to a webhook.

Create online forms

Add HTML forms to your site in a snap—no coding required.

Change Language