​
CSV Upload Points

The CSV Upload feature allows you to issue points to multiple users at once by uploading a CSV file containing user identities and point values.

​
CSV Format Requirements

Your CSV file must include:

  1. A header row with column names
  2. A column for user identities (addresses, emails, etc.)
  3. A column for point values

Example CSV format:

wallet_address,points,action
0xB58621209Dc0b0c514E52a6D9A165a16ae95e4f7,100,community_contribution
0x742d35Cc6634C0532925a3b844Bc454e4438f44e,50,event_attendance
0x1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t,75,content_creation

You can include additional columns for your own reference, but you’ll need to specify which columns contain the identity and points values during the upload process.

​
CSV Validation Rules

When uploading a CSV file, the system will validate your data according to these rules:

  1. Identity values must match the specified identity type format:

    • EVM addresses must be valid Ethereum addresses (0x followed by 40 hex characters)
    • Solana addresses must be valid base58 strings (32-44 characters)
    • Bitcoin addresses must follow BTC address format
    • Email addresses must be in valid email format
    • Discord IDs must be 17-19 digits
    • X/Twitter handles must be 1-15 alphanumeric characters or underscores
    • GitHub usernames must follow GitHub username format

  2. Point values must be:

    • Valid numbers
    • Greater than or equal to zero (no negative points)
    • Finite numbers

  3. Duplicate identities will be flagged as warnings but will still be processed

  4. Empty or invalid entries will be flagged as errors and must be corrected before processing

​
Identity Types

When uploading a CSV, you’ll need to specify which type of identity is in your identity column:

Identity TypeDescription
EVM_ADDRESSEthereum addresses (e.g., “0xB58621209Dc0b0c514E52a6D9A165a16ae95e4f7”)
SOLANA_ADDRESSSolana addresses (e.g., “8ZUkk8pTyEAjyHbmBBXdrDNiNZ9D9Gcn5HgqxEjD8aHn”)
BTC_ADDRESSBitcoin addresses (e.g., “1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa”)
EMAILEmail addresses (e.g., “user@example.com”)
DISCORD_PROVIDER_IDDiscord numeric IDs (not usernames)
X_PROVIDER_IDX/Twitter numeric IDs (not usernames)
GITHUB_PROVIDER_IDGitHub numeric IDs (not usernames)

​
Using the Dashboard

The easiest way to upload a CSV is through the Absinthe dashboard:

  1. Navigate to your season in the app.absinthe.network dashboard
  2. Go to the “Points” section and select “CSV Upload”
  3. Create a new CSV upload source
  4. Upload your CSV file
  5. Map the identity column and points column
  6. Select the identity type
  7. Validate the CSV
  8. Publish the source to issue points

​
Best Practices

  • Keep your CSV files organized: Use clear column headers and consistent formatting
  • Validate before publishing: Always validate your CSV data before publishing to catch any errors
  • Use appropriate identity types: Make sure you select the correct identity type for your data
  • Limit file size: For optimal performance, keep CSV files under 10,000 rows
  • Include metadata: Consider adding additional columns for your own reference and tracking

For large CSV files, consider breaking them into smaller batches to improve processing speed and reduce the chance of timeouts.

​
FAQ

The CSV upload feature is designed for one-time or periodic bulk point issuances. For real-time or event-triggered point issuances, consider using our GraphQL API or integrations with platforms like Zapier.