Getting Started5 min read

Uploading Your First Lead List

Learn how to prepare your CSV, upload it to Trust Leads, and monitor the enrichment job.

uploadcsvfile formatenrichmentjob

Preparing Your CSV File

Trust Leads accepts CSV files with a header row. The column names do not need to match any specific format — our engine automatically detects common column names like 'email', 'Email Address', 'e-mail', 'phone', 'Phone Number', 'first_name', 'last name', and many more.

The minimum requirement is one column containing email addresses. The more data you provide (first name, last name, company name, phone number, job title), the richer the output will be, since we can use additional fields to cross-validate contacts and improve scoring accuracy.

  • Required: at least one column with email addresses
  • Recommended: first_name, last_name, company, phone, job_title
  • Maximum file size: 10 MB on Free/Starter, 50 MB on Pro, 200 MB on Agency
  • Maximum rows: 500 on Free, 10,000 on Starter, 50,000 on Pro, 250,000 on Agency
  • Encoding: UTF-8 (files in Windows-1252 are auto-converted)

Tip

Remove any columns with sensitive personal data that are not needed for enrichment (e.g. bank account numbers, health data) before uploading. Trust Leads does not need this information.

Uploading the File

Navigate to the Enrichment page (/app/enrich) and click the upload area or drag your CSV file onto it. The file is immediately validated for size, encoding, and structure. If any issues are detected (wrong format, no email column found, file too large), a clear error message will be displayed before any credits are consumed.

After a successful upload, you will see a preview of the first 5 rows with column detection highlighted. Review the detected columns and confirm the mapping if everything looks correct. If the auto-detection mapped a column incorrectly, you can override it using the dropdown next to each column header.

Monitoring Your Job

Once submitted, your enrichment job enters the processing queue. Free and Starter plan jobs are typically processed within 2–5 minutes for files under 1,000 rows. Pro and Agency jobs receive priority queue placement and usually complete in under 60 seconds.

The job status is shown in real time on the Enrichment page and in the Job History page (/history). Status values are: Queued, Processing, Complete, and Failed. You do not need to keep the browser open — jobs run server-side and you can return to download results at any time within 30 days.

Tip

You will receive a notification email when your job completes. Make sure your notification preferences are enabled in Settings.

What Happens to Your Credits

Credits are consumed only when a job completes successfully. If a job fails due to a server error (not a user error), credits are automatically refunded. If a job fails because the uploaded file was malformed, credits are not consumed because no processing occurred.

Each row in your CSV consumes one credit from your monthly quota (or from your credit pack balance if you have purchased credits). The quota deduction is shown on the job completion screen and in the Job History page.


Was this guide helpful?