Cage

Cage Service Docs

Documentation Hub

Password Merger

Batch-change email account passwords using the Firstmail API. The Password Merger reads accounts with old and new passwords, changes them via the API, and outputs the updated credentials.

Prerequisites

Workflow

Load accounts from input file (readyAccounts.txt)

For each account, call the Firstmail API to change the password

Multi-threaded processing for speed

Save updated accounts to output file (changedAccounts.txt). 2FA secrets are preserved automatically.

Log failures for manual review

Configuration Reference

FieldKeyTypeDescription
Firstmail API Keyapi_keystringYour Firstmail API authentication key
Input Fileinput_filestringPath to input file (default: readyAccounts.txt)
Output Fileoutput_filestringPath to output file (default: changedAccounts.txt)
Max Workersmax_workersintegerNumber of parallel threads
DelaydelayfloatDelay between API calls in seconds

Input / Output Format

Input (readyAccounts.txt):

email:oldpassword:newpassword
email:oldpassword:newpassword:2fasecret

Example:

john.doe@firstmail.ltd:OldPass123:NewPass456
sarah99@firstmail.ltd:MyOld!Pw:MyNew!Pw
max.muster@firstmail.ltd:Secret99:Secret100:WCIZO2IPEK77XBYW6ENKD56FLY

Output (changedAccounts.txt):

email:newpassword
email:newpassword:2fasecret

Example:

john.doe@firstmail.ltd:NewPass456
sarah99@firstmail.ltd:MyNew!Pw
max.muster@firstmail.ltd:Secret100:WCIZO2IPEK77XBYW6ENKD56FLY
Accounts with a 2FA secret key (4th field) will automatically have it preserved in the output. No extra configuration needed.

Tips

Get your API key from the Firstmail dashboard under API settings.
Keep the delay reasonable to avoid rate limiting from the API.

Next Steps