Email Automated Batch allows you to process multiple email addresses in one go. You simply upload a file (of a specific format) to an SFTP site which is then processed and made available for download.
Email validation will check each email address for authenticity and return one of the 6 result types suggesting corrections where appropriate.
Deployed as a daily or weekly process, Email Automated Batch will validate all new or incoming emails into your customer database.
Depending on the size of your file, the processing may take up to 24 hours to complete.
Read more about the output file specification and how to interpret the results.
When uploading files, there are file formatting requirements that must be adhered to. If these requirements are not met, the file will be rejected.
Ensure that these input requirements are met before proceeding.
Uploaded files must be RFC 4180-compliant CSVs:
In addition to the above, a header row named 'email' (case-insensitive) is required.
Additional columns may be included and will be retained in the output, but they cannot be named as 'result' or 'correction'. The maximum file size is 2GB and the maximum record count is 1 million records.
You can either upload files via a Windows FTP client or via UNIX command line:
Username and Password: (password is your API key)
All non-specified values should be left as the program’s default settings.
If you get a message asking whether you trust the host key provided by our servers, simply click OK to proceed. You can also select the checkbox to remember this decision.
Once processing is complete, you can download the files and view the results.
Output files will adhere to the same format as used for input but will contain additional fields named result and correction.
To simplify parsing (e.g. for direct, MS-SQL bulk import), every field will be quoted.
Corrections may be provided if the submitted email address is incorrect. These are suggestions and may not relate to the person in your database.
Please get approval from your legal team/department before using these corrections.
These suggestions are not a guarantee that the email addresses are correct, nor that they can be used in any specific manner. They may, therefore, be emails you are not authorized to send to.
You can expect your file to be validated within 24 hours (if less than 100,000 records) although the email addresses in the file will also determine performance. When processing has completed, the file will automatically be moved to the outgoing folder.
Please take care when deleting files.
Using the SFTP interface, you may delete files from both the incoming and outgoing folders using the standard SFTP delete functionality. However, please use this functionality with care as backups of your files are not made once the delete functionality has been used. If you delete by mistake, the file will need to be re-uploaded and you will be charged for it as a new file.
Deleting files from the incoming folder will result in the file processing being halted and all contents removed. All input fields and output results will be deleted and the file will not be available for view in the incoming folder or for download in the outgoing folder.
Deleting files from the outgoing folder will result in all data relating to this file being permanently removed from our platform and the file no longer being available for download.
|verified||verified||Mailbox exists, is reachable, and not known to be illegitimate or disposable.|
|mailboxDisabled||The user mailbox has been disabled.|
|mailboxDoesNotExist||The user mailbox does not exist at this domain.|
|mailboxFull||The user mailbox is full.|
|syntaxFailure||The syntax of the email address is incorrect.|
|unreachable||The domain is not responding to validation requests or does not have any active mail servers.|
|unresolvable||The domain cannot be resolved.|
|illegitimate||Seed, spamtrap, black hole, technical role account or inactive domain.|
|roleAccount||Role accounts such as support@, sales@, info@ .|
|typoDomain||The domain was close to a common domain and although it exists, it is highly unlikely to be correct.|
|disposable||disposable||Domain is administered by a disposable email provider (e.g. Mailinator).|
|unknown||We were unable to conclusively verify or invalidate this address.|
|timeout||The request timed out due to the host domain not responding in time.|
|acceptAll||The domain is accept-all, so the username cannot be validated.|
* The VerboseOutput values might not be visible to you due to your configuration.
We recommend that you remove/fix email addresses that are undeliverable, unreachable, illegitimate or disposable.
Additional information on how to manage the result types can be provided by your account manager or the local support team.
SSL certificate errors
Your SSL certificate might have expired. To manually update your deployment:
This usually happens due to typos in the supplied username/password. However, if you're confident that you are entering the right details, please contact your local support team.
Uploaded file is not in the 'Incoming' folder
This could be the result of a malformed file. Check your SFTP client’s message log for further information on why it was rejected. Additionally, if you have email notifications enabled you will receive an email with a description of the error.
Can't delete a file from the 'Incoming' folder
Once the file processing has begun, you will not be allowed to delete the file. If you believe the processing has completed and you still can't delete the file, please contact our support team.
Result file is not in the 'Outgoing' folder
This is likely to be due to a failed job. You should receive an email notification that containing a description of the error you've encountered.
Errors can be caused by files that:
How do I unlock my account?
The account lock was implemented for security purposes and occurs after too many failed login attempts. To unlock, please contact your local support team.
How do I change my SFTP password?
What's the status of my upload?
An email notification will be sent to you when an upload has failed or when a file has completed processing. Here are the reasons that can cause the processing job to fail:
|Maximum file size exceeded||Ensure the file does not exceed 2GB.|
|Exceeds maximum record size||Ensure the number of records does not exceed 1 million.|
|No valid data row found||Potential issues:
|Email column not found||The 'email column header was not found.|
|There were some error(s) processing the job||Can be caused by an internal exception error.
Please try resubmitting the file or contact our support team if the problem still exists.
|Insufficient Credit||Your account is running out of credits. Please contact your account manager for more information.|
|License Disabled||Your license has been disabled. Please contact your account manager for more information.|
What are the downtime procedures?
The processing platform may occasionally be unavailable due to maintenance. Your account manager will notify you in advance of any scheduled maintenance periods.
How do I manage clicks, credentials, and reporting?
Please contact your account manager or the local support team for more information.