ZeroBounce Email Validation
1 -
Validate Email with ZeroBounce
Add Choice
Installing a custom flow step requires Admin permissions in Marketo. Apart from the Installation URL, all other aspects of a serviced may be edited after completing initial onboarding by drilling down into the service detail screen from the Service Providers grid.
In Marketo navigate to Admin → Service Providers and click Add New Service
From here, follow the bellow steps to install and configure the flow step.
Flow Step Service
Confirm installation
To begin installation, you’ll need to first enter the install URL of the Validate Email with ZeroBounce flow step shown above. This URL gives Marketo the basic information it needs to connect to and configure the flow step.
Flow Step Service
Enter Credentials
Please provide an API Key. Valid API credentials from Flowsteps.io are required to complete installation.
After you enter the installation URL you will be asked to enter your API Key. When you save your credentials, Marketo will attempt to verify that it is valid. If the credentials provided are invalid, you’ll see an error indicating this.
Flow Step Service
Map Outgoing Fields
Map Incoming Fields
Configuration Options
Flowsteps.io has provided a list of required and optional fields to map to Marketo Lead fields. Fields which are mapped and active will be sent to the service provider when Validate Email with ZeroBounce is invoked from a Smart Campaign. Required mappings must be completed and be active in order to complete service installation.
| Active | External Field | Type | Description | Marketo Field |
|---|---|---|---|---|
|
|
Email address to validate |
email
|
||
|
|
ip_address | string | IP Address to check with email |
anonymousIP
|
The Outgoing Fields, are sent to the Validate Email with ZeroBounce flow step. Be sure to activate and map all required fields.
After you enter the installation URL you will be asked to enter your API Key. When you save your credentials, Marketo will attempt to verify that it is valid. If the credentials provided are invalid, you’ll see an error indicating this.
Flow Step Service
Map Incoming Fields
Configuration Options
Approve Contexts & Finish
Flowsteps.io has provided a list of response mappings to map to Marketo Lead fields. Fields which are mapped and active may be written to by Flowsteps.io, when processing of Validate Email with ZeroBounce is complete. Response Mappings are not required to complete service installation, but the service may not function as expected if mappings are not provided.
| Active | External Field | Type | Description | Marketo Field |
|---|---|---|---|---|
|
|
* status | string | [valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail] |
zBStatus
|
|
|
emailDetails | string | emailDetails |
emailDetails
|
|
|
sub_status | string | [antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic] |
zBSubStatus
|
|
|
account | string | The portion of the email address before the '@' symbol. |
zBAccount
|
|
|
domain | string | The portion of the email address after the '@' symbol. |
zBDomain
|
|
|
domain_age_days | integer | Age of the email domain in days or [null]. |
zBDomainAge
|
|
|
free_email | boolean | [true/false] If the email comes from a free provider. |
zBFreeEmail
|
|
|
mx_found | boolean | [true/false] Does the domain have an MX record. |
zBMXFound
|
|
|
mx_record | string | The preferred MX record of the domain |
zBMXRecord
|
|
|
smtp_provider | string | The SMTP Provider of the email or [null] |
zBSMTPProvider
|
The Validate Email with ZeroBounce flow step uses set inbound fields. Below are the fields that are returned from the flow step and can be written to the person based on the mapping you set.
Flow Step Service
Map Incoming Fields
Configuration Options
Approve Contexts & Finish
Flowsteps.io has provided a list of required and optional configuration settings. These settings will be used globally by Validate Email with ZeroBounce.
Global user inputs that are passed along with every call to the Validate Email with ZeroBounce flow step service. Global attributes can be set during installation or updated from the Service Provider admin menu.
Flow Step Service
Map Incoming Fields
Configuration Options
Approve Contexts & Finish
Flowsteps.io is requesting access to the following data contexts. When Validate Email with ZeroBounce is invoked from a Smart Campaign, the data from these objects will be sent as contextual information to Flowsteps.io, such that processing may be completed.
Subscription
Program
Program Member
Smart Campaign
Trigger
My Tokens
Finally review the context data that will be sent to the to Validate Email with ZeroBounce flow step, and approve.
Outbound Fields
The Validate Email with ZeroBounce flow step uses set outbound fields. Below are the person fields that are sent to the flow step based on the mapping you set.
| Name | API Name | Type | Description |
|---|---|---|---|
| Email address to validate | |||
| ip_address | string | IP Address to check with email |
Inbound Fields
The Validate Email with ZeroBounce flow step uses set inbound fields. Below are the fields that are returned from the flow step and can be written to the person based on the mapping you set.
| Name | Suggested Marketo Field | Description |
|---|---|---|
| status | zBStatus | [valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail] |
| emailDetails | emailDetails | emailDetails |
| sub_status | zBSubStatus | [antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic] |
| account | zBAccount | The portion of the email address before the '@' symbol. |
| domain | zBDomain | The portion of the email address after the '@' symbol. |
| domain_age_days | zBDomainAge | Age of the email domain in days or [null]. |
| free_email | zBFreeEmail | [true/false] If the email comes from a free provider. |
| mx_found | zBMXFound | [true/false] Does the domain have an MX record. |
| mx_record | zBMXRecord | The preferred MX record of the domain |
| smtp_provider | zBSMTPProvider | The SMTP Provider of the email or [null] |
Global Configuration Fields
Global user inputs that are passed along with every call to the Validate Email with ZeroBounce flow step service. Global attributes can be set during installation or updated from the Service Provider admin menu.
| Name | API Name | Type | Description |
|---|---|---|---|
| ZeroBounce Email Validation API Key | api_token | string | ZeroBounce Email Validation API Key |
Flow Step Fields
These fields are set for each individual instance of the Validate Email with ZeroBounce flow step and are sent per-lead when it is called.
| Name | API Name | Type | Description |
|---|---|---|---|
| Use IP Address | use_ip | boolean | Use anonymous IP address in email validation lookup for more detailed response |
Context Data
| Name | Description |
|---|---|
| Program Context | Data about the program where the flow step was triggered including name, id, type, workspace etc. |
| Campaign Context | Data about the campaign where the flow step was triggered, including name, id, type, status, etc. |
| Trigger Context | Context around the trigger that initiated the smart campaign where the flow step was called. No data is sent if the flow step was called in a batch campaign. |
| Subscription Context | General data about the subscription including munchkinId and name |
Flow Step
Once the ZeroBounce Email Validation flow step is installed it becomes available in smart campaigns.
1 -
Validate Email with ZeroBounce
Add Choice
Trigger & Filter
Once the ZeroBounce Email Validation flow step is in use the activity can be used as a trigger or a filter inside smart lists and smart campaigns.
Validate Email with ZeroBounce is requested
1 - Validate Email with ZeroBounce was requested