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:
- Log in and go to Forms.
- To the right of the form, hover over More and click API Information.
- Copy your API Key, or look at the table to find your form's hash or field API IDs.
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.
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.
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.
You can use URL modifications to prepopulate fields in your form. Add the Field API ID for the field you want to prepopulate and the value you want filled in to the end of your form's URL using the following format:
You can use your hashed URL or the friendly URL and people filling out your form will be able to replace your custom values with their own responses when filling out your form. This feature can let you give users a place to start or provide instructional, placeholder text.
Combine custom values with an ampersand to fill in multiple fields using the same link. The below would place “wufoo” in field5 and “today” in field6 when your form loads. The end of the URL can carry on forever as long as it follows the fieldX=value&fieldY=value2 format.
'defaultValues':'field1=wufoo'. For example:
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:
- Log in and go to Forms.
- To the right of the form, hover over Edit and click Add Notifications.
- Click the dropdown menu and choose WebHook.
- Click Add Integration.
- Enter your WebHook URL—the URL where Wufoo should send the HTTP POST.
- Enter your WebHook Handshake Key (optional).
- Select Include Field and Form Structures with Entry Data if you'd like the POST request to include metadata about your form’s fields.
- Click Save.