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:
  • A connector in IBM App Connect Enterprise as a ServiceApp Connect Enterprise as a Service connector
  • A connector in IBM App Connect on IBM CloudCloud-managed 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 (Extended Update Support)Local connector in containers (Extended Update Support 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)
The following information describes how to use IBM App Connect to connect Wufoo to your other applications.

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.
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 Catalog 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 Catalog page of the App Connect Designer.

    For some applications, the events and actions in the catalog depend on the environment (IBM Cloud Pak for Integration or App Connect on IBM Cloud) 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 performing the actions in the flow.

Form entries
New form entry

Wufoo actions

These are actions on this application that you want a flow to complete.

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