This API allows you to upload a file containing email addresses or their MD5 hashes of individuals who you do not wish to be resolved by Retention.com. This is crucial for complying with "do not sell" requests and ensuring data privacy for your customers. You can make up to 5 requests per day, with each request handling 40,000 emails a day.
For a successful integration, please refer to the API guide, which provides detailed information on the rules and limitations applicable to this endpoint.
File Format
The uploaded CSV file should adhere to the following format:
-
Plain Text Encoding: Ensure the file is encoded in plain text (e.g., UTF-8).
-
One Entry Per Row: Each email address or MD5 hash should be on a new line.
-
Optional Header Row: The first row of the file can be a header row with column names, which will be skipped during processing.
-
Supported Content: Each row should contain either a valid email address or a 32-character lowercase hexadecimal MD5 hash.
Example (Emails):
Example (MD5 Hashes):
hash e10adc3949ba59abbe56e057f20f883e d41d8cd98f00b204e9800998ecf8427e a5d4c3b7d6e0b2a1f83d7e9c5f0d9a2b
For consistent identification, ensure email addresses are converted to lowercase before generating their MD5 hash.