Navigate...
Import from CSV
sdk.lists.importFromCsv(listId, file)
Import recipients into an existing list from a CSV file upload. Uses multipart/form-data. Returns detailed results including added count, total list size after import, and failed rows with reasons. Duplicate addresses already in the list are silently ignored.
API key required to run methods
API Key *
Base URL
listId
string
required
List ID to import into
List ID
CSV File *
No file selected
Returns
ImportListResponse
Detailed import results with success/failure breakdown
added
number
Number of recipients successfully imported
totalItems
number
Total recipients in list after import
totalFailed
number
Number of rows that failed validation
failed
FailedRow[]
First 100 failed rows with row number, address, and reason
failed[].reason
string
invalid_address | missing_amount | invalid_amount | invalid_chainId | metadata_too_long | invalid_metadata_json | unknown_error
Errors
Invalid file
Invalid list id
The request is not authorized
You do not have permission to access this resource
List not found
See Also
importCsvDistribution()
Create a new list from CSV string instead of uploading into existing
addRecipientsBulk()
Add recipients programmatically as JSON
Generated Code