URL Modifications
On this Page
API Information
To locate account API information, log in to Wufoo and click “Account” in the top right. From there, click the button labeled “API Information.” You will be presented with an API key followed by a list of all forms and fields. The fields are the important part here because they will determine what value is being placed where. Each field has a numerical Id next to it. To reference a given field in the URL, place the word “field” in front of the Id. So a field with an Id of 5 will become:
field5
URL Format
The basic URL of a Wufoo form will be the core of the custom URL. The basic URL looks like this:
http://username.wufoo.com/forms/form-name/
If a user clicks on the form link, they will be taken to the form with no predefined values. To find the URL for your specific Wufoo form, click the “View” button listed underneath the form name in the Form Manager. Next, to add a custom value, we have to append more onto the end of the URL:
http://username.wufoo.com/forms/form-name/def/field5=wufoo&field6=today
The above URL would place “wufoo” in field5 and “today” in field6 when the form loads up. Remember to reference your account API section for the Id of fields on your form. The end of the URL can carry on forever as long as it follows the fieldX=value&fieldY=value2 format. Each field is separated by an “&” character.
Formatting Tips
Certain characters are not allowed in a URL, but you may wish to have them as your default value. For example, let’s say we wish to place “Are you sure?” as the default value of field5. The problem here is that the “?” character is reserved. In this case, the URL must be formatted with encoding.
http://username.wufoo.com/forms/form-name/def/field5=Are%20you%20sure%3F
The %20 represents a space, and the %3F a question mark. Here is a full list of character equivalents:
space %20
# %23
$ %24
% %25
& %26
/ %2F
: %3A
; %3B
< %3C
= %3D
> %3E
? %3F
@ %40
[ %5B
\ %5C
] %5D
^ %5E
` %60
{ %7B
| %7C
} %7D
~ %7E
Conflicting Values
There are two types of conflicting values: bad characters in the URL, and default values set from within the Wufoo admin interface.
Default values set in the Wufoo admin interface will override those set with a URL.
An “&” character, or
%26, does not currently work.A single “/”, or
%2F, will work just fine. But if you place two together, right next to one another, the URL will not read them correctly.
Turning off SSL
By default, all accounts that are SSL enabled will have SSL forced upon every form. In some settings, mainly due to browser configuration, SSL is not desired. We can override SSL by slightly modifying the URL for a form.
http://username.wufoo.com/forms/form-name/http/true
The important parts are in bold:
- Make sure you use http instead of https.
- Follow the form name by the word http.
- Follow http by any word of your choosing. The example above uses true.
