Clean Bulk Emails

Submit a batch of email addresses for cleaning. Provide either a CSV file upload (multipart/form-data) or a JSON body with an emails array (max 500). Cleaning runs asynchronously; the response returns a job_uuid to poll with Get Cleaning Status or to download once complete. By default the account owner is emailed when the job finishes; supply notify_email to send elsewhere, or an HTTPS callback_url to receive a webhook instead of an email.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
emails
array of strings
required
length ≤ 500

Email addresses to clean (max 500). Use a CSV upload for larger batches.

emails*
uri

Optional HTTPS webhook called when the job completes. When set, no notification email is sent.

string

Optional address to notify on completion. Defaults to the account owner.

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

402

Insufficient credits to clean this batch.

422

Validation failed (invalid file, too many emails, or contact limit reached).

429

A matching job is already processing, or the submit rate limit was exceeded.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json