Skip to content
English
Contact Us
  • There are no suggestions because the search field is empty.

Bulk payments (CSV): required fields

Bulk payments let you upload a CSV to add recipients or prepare payments faster instead of entering everything manually. This is especially useful when you’re onboarding many workers/contractors at once.

What you need in your CSV (required fields)

Required (always)

  1. Email

  • This is where the invitation is sent and how Bitwage identifies the recipient.

  1. Role Type

  • Must be one of: Worker, Contractor, or Admin

  • Role Type controls what the user can do in Bitwage (for example: contractors can create invoices).

For role definitions and best practices, see: Invite teammates: roles, who should have access.

Optional field (sometimes required)

Worker ID (only if you’re syncing to another payroll service)

Some companies include a Worker ID when they need Bitwage recipients to match an external payroll system record (for syncing or reconciliation).

  • Worker ID = your internal or payroll provider’s unique identifier for that person

  • Use it when your setup requires a 1:1 match between systems

Common upload issues (and how to avoid them)

  • Wrong role spelling: use exactly Worker / Contractor / Admin

  • Invalid emails: double-check typos (most common cause of failed invites)

  • Missing required columns: make sure Email + Role Type are included