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.
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 (previously the Catalog page) or flow editor. If necessary, work with your Hunter administrator to obtain these values.
- Server URL is the URL for the API server that makes runtime calls.
- API key is the API key that is used to authenticate your account when making API calls.
- Set Allow self-signed certificates 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 is required if you want to connect to an endpoint in
a private network by using the private network client, or 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're not using the private network client or don't need an override, don't complete this field. - Private network connection: Select the name of a private network agent that App Connect uses to connect to your private network. This list is populated with the names of private network agents that are created on the Private networks page. For more information, see Connecting to a private network.
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. For more information, see Managing accounts.
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 by using the 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 list of leads | |
| Delete leads list | Deletes an existing list of leads | |
| Update leads list | Updates an existing list of leads | |
| 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 given name, and a surname |
| 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, go to the Discover page and search for Hunter.
Use IBM® App Connect to build flows that integrate with Hunter.
The following blog post describes how to add recipients to a campaign by 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.