How to use IBM App Connect with Hunter
Hunter is a platform that is used for finding, verifying, and enriching professional contacts through email outreach. The platform offers tools such as an email finder, email verifier, and personalized email campaigns.
App Connect
Enterprise as a Service connector-
Local
connector in containers (Continuous Delivery release) 12.0.12.2-r1 or later -
Local connector in containers (Long Term Support Cycle-2 release)
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 Hunter
Complete the connection fields that you see in the App Connect Designer page or flow editor. If necessary, work with your Hunter administrator to obtain these values.
Hunter connection fields:
- Server URL: Specify the URL for the API server that makes runtime calls.
- API key: The API key that is used to authenticate your account when making API calls.
- Allow self-signed certificates: Set to true or false. Set to true if you want to be able to accept self-signed certificates that are trusted and used only in a nonproduction environment. The default is false.
- Override server URL: Required if you want to connect to an endpoint in a
private network by using the private network client, or if you want to override the server URL.
Specify an override value for the host and port for the connector in the format
<http or https>://<host_name>:<port>. If you are not using the private network client or do not require an override, leave this field blank. - Private network connection: Select the name of a private network
connection that App Connect uses to connect to your private
network. This list is populated with the names of private network connections that are created from
the
Private network connections
page in the Designer instance. You see this field only if a switch server is configured for this Designer instance. For more information, see Connecting to a private network from App Connect Designer. (In App Connect Designer 12.0.10.0-r1 or earlier instances that include this field, the display name is shown as Agent name.)
To obtain the connection values for Hunter, see Obtaining connection values for Hunter.
To connect to a Hunter endpoint from the App Connect Designer Applications and APIs page for the first time, expand Hunter, then click Connect.
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
Before you use App Connect Designer with Hunter, take note of the following considerations:
- 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.
- If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
Events and Actions
Hunter events
These events are for changes in this application that trigger a flow to start completing the actions in the flow.
Hunter actions
Your flow completes these actions on this application.
| Object | Action | Description |
|---|---|---|
| Leads | Retrieve all leads | Retrieves all the leads already saved in your account |
| Create lead | Creates a new lead | |
| Update or create lead | Creates a new lead if it doesn't exist yet based on email address, or updates it if it does | |
| Delete lead | Deletes an existing lead | |
| Retrieve lead by ID | Retrieves all the fields of a lead using lead ID | |
| Update lead | Updates an existing lead | |
| Leads lists | Create leads list | Creates a new leads list |
| Retrieve all leads lists | Retrieves all the leads lists already saved in your account | |
| Retrieve leads list by ID | Retrieves all the fields of a leads list | |
| Delete leads list | Deletes an existing leads list | |
| Update leads list | Updates an existing leads list | |
| Campaigns | Retrieve all campaigns | Retrieves all the campaigns in your account |
| Retrieve recipients of a campaign | Retrieves all the recipients of a campaign | |
| Add recipient to a campaign | Adds a recipient to a campaign | |
| Cancel scheduled emails to recipient from a campaign | Cancels scheduled messages to a recipient from a campaign | |
| Emails | Find email | Used to find the most likely email address from a domain name, a first name, and a last name |
| Domains | Search email addresses by domain | Searches all the email addresses corresponding to one website |
Examples
Use templates to quickly create flows for Hunter
Learn how to use App Connect templates to quickly create flows that complete actions on Hunter. For example, open the Templates gallery, and then search for Hunter.
Use IBM® App Connect to build flows that integrate with Hunter.
Read the blog in the IBM Community to learn how to add recipients to a campaign using Hunter when a Google Calendar event is scheduled. Click Read the blog to go to the blog.
Use IBM App Connect to build flows that integrate with Hunter.
Read the blog in the IBM Community to learn how to search people from an organization by email domain in Hunter and create or update contacts in Salesforce. Click Read the blog to go to the blog.