Docs
Hanko Docs

CSV Import#

Add many payout recipients at once by uploading a CSV file. The importer auto-detects the address and amount columns, plus an optional email column.

Recipients section with CSV import button and drag-and-drop zone
  1. 1Import CSV button
  2. 2Drag and drop a CSV here
  3. 3Download a sample CSV

Supported format#

Give your CSV a header row. The importer auto-detects:

  • Address — EVM wallet address (0x...). Required.
  • Amount — Numeric amount to send. Required.
  • Email — Optional. Used to notify the recipient.

Rows with an invalid or missing address or amount are reported and skipped. Click Download sample CSV to get a correctly formatted starter file.

Warning

Addresses are validated as EVM addresses. After import, check the result banner for the number imported and any skipped rows, then fix them.

Import steps#

Prepare your CSV

Create a file with a header row and one row per recipient. Example:

addressamountemail
0x1234...100alice@example.com
0x5678...250.50bob@example.com
Upload

In the create-payout flow, click Import CSV and choose your file, or drag the file onto the drop zone in the Recipients section.

Review

A banner reports how many recipients were imported and which columns were detected. Imported rows are appended to your existing recipients.

After import you can still add, edit, or remove rows and adjust amounts before executing. The same CSV import is available when building a template.