How to use IBM App Connect with Wufoo

Wufoo is a web-based form builder that you can use to create forms, including contact forms, online payments, online surveys, and event registrations. Use IBM® App Connect to connect Wufoo to other applications. For example, you can use IBM App Connect to update other systems automatically when a form is submitted in Wufoo. Similarly, IBM App Connect can complete and submit forms automatically in response to updates in your other applications.

Availability:
  • App Connect Enterprise as a Service connector
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release)
  • A local connector in a Designer instance of IBM App Connect in containers (Long Term Support)Local connector in containers (Long Term Support release)
  • A local connector in a Designer instance of IBM App Connect in containers (Support Cycle 2)Local connector in containers (Long Term Support Cycle-2 release)
The following information describes how to use IBM App Connect to connect Wufoo to your other applications.

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Wufoo

You can connect to Wufoo in the IBM App Connect catalog. Alternatively, you can connect to Wufoo in the flow editor when you add a Wufoo event or action to a flow. To connect IBM App Connect to Wufoo, you provide the following connection information.
API key
To obtain the API key for your account, you must have at least one form in Wufoo.
  1. Log in to your Wufoo account.
  2. Open the Form Manager by clicking Forms.
  3. To retrieve your API key, click More, then click API information. The API key is shown on the API Information page and is in the format XXXX-XXXX-XXXX-XXXX.
Subdomain
To retrieve your subdomain, click Account, then click My Account. The subdomain is the part of the URL between https:// and wufoo.com. For example, if the full URL is shown as https://yourSubdomain.wufoo.com, set the Subdomain field to yourSubdomain.

To connect to a Wufoo endpoint from the App Connect Designer Catalog page for the first time, expand Wufoo, then click Connect. For more information, see Managing accounts.

Tip:
  • If you don't have a Wufoo account, you can create an account for the Wufoo free plan to try Wufoo for free.

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

General considerations

  • (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

    For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

  • Before you add some of the Wufoo events or actions to your flow, make sure that you have the following resources.
    • The New form entry event triggers your flow every time someone submits a completed Wufoo form. Therefore, to use this event in a flow, you must have a public form in Wufoo. You then specify the name of this form when you add the event to your flow.
    • The Create form entry action completes and submits a Wufoo form by using data from the preceding applications in your flow. Therefore, to use this action in a flow, you must have a public form in Wufoo so that IBM App Connect can fill it in. You then specify the name of this form when you add the action to your flow.
  • The polling interval for the Wufoo connector when used in a running flow is 120 seconds, for all Wufoo plans. This means that every 2 minutes, the connector asks Wufoo to check for new data. (This polling interval is on a higher side to prevent Wufoo API limits being reached too much.)
    Tip: If you are using an account for the Wufoo free plan, then you can use the Wufoo connector with that account for up to about 3 hours in one running flow. If you use the same Wufoo free plan account in other flows, then the flow can use the Wufoo connector for less time.

    To connect to an account for the Wufoo free plan, consider running only one flow per day.

  • If a flow is triggered by a Wufoo event, you can experience a slight delay (5 minutes) in getting new records. This delay is primarily due to the following factors:
    • The time that Wufoo takes to make a new record ready for querying. This is around 3 to 4 minutes on average.
    • When a record is made available by Wufoo, the record is retrieved by App Connect within the next 120 seconds.

Events and actions

Wufoo events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Note: In containers, only local accounts can be used for these events.
Form entries
New form entry

Wufoo actions

Your flow completes these actions on this application.

Form entries
Create form entry
Retrieve form entries
Forms
Retrieve forms
Reports
Retrieve reports
Users
Retrieve users

Examples

Dashboard tile for a template that uses Wufoo
Dashboard tile for a template that uses Wufoo
Dashboard tile for a template that uses Wufoo

Use templates to quickly create flows for Wufoo

Learn how to use App Connect templates to quickly create flows that complete actions on Wufoo. For example, open the Templates gallery, and then search for Wufoo.

Dashboard tile for a template that uses Wufoo