API referencellms.txt
Set-asides
Rules for saving from a taxpayer’s deposits.
Create a set-aside
POST
/v1/set_asidesStarts saving. Replaces any rule the taxpayer already has.
Fields
taxpayer_idstringRequired- The taxpayer, like
tp_8Kq2. rulestringRequiredpercent_of_depositsorfixed.percentinteger- For
percent_of_deposits: 1 to 60. amountinteger- For
fixed: cents per period. schedulestring- For
fixed:weekly,monthlyorbefore_due.
curl -X POST "https://api.workmade.com/v1/set_asides" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "taxpayer_id": "tp_8Kq2", "rule": "percent_of_deposits", "percent": 24 }'
{
"id": "sa_3Rm8",
"object": "set_aside",
"taxpayer_id": "tp_8Kq2",
"rule": "percent_of_deposits",
"percent": 24,
"status": "active",
"authorization": {
"type": "ach_debit",
"accepted_at": "2026-03-02T15:06:40Z"
}
}Report a deposit
POST
/v1/depositsTells us about income so we save its share.
Fields
taxpayer_idstringRequired- The taxpayer, like
tp_8Kq2. amountintegerRequired- In cents.
received_onstringYYYY-MM-DD. Defaults to today.
curl -X POST "https://api.workmade.com/v1/deposits" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "taxpayer_id": "tp_8Kq2", "amount": 400000, "received_on": "2026-10-03" }'
{
"id": "dep_9Lp3",
"object": "deposit",
"taxpayer_id": "tp_8Kq2",
"amount": 400000,
"saving": 96000
}Retrieve the balance
GET
/v1/taxpayers/tp_8Kq2/balanceHow much is saved and whether it covers this quarter.
curl "https://api.workmade.com/v1/taxpayers/tp_8Kq2/balance" \ -H "Authorization: Bearer $WORKMADE_KEY"
{
"object": "balance",
"taxpayer_id": "tp_8Kq2",
"saved": 544500,
"owed_this_quarter": 544500,
"short_by": 0
}POSTCreate a set-aside
curl -X POST "https://api.workmade.com/v1/set_asides" \ -H "Authorization: Bearer $WORKMADE_KEY" \ -H "Content-Type: application/json" \ -d '{ "taxpayer_id": "tp_8Kq2", "rule": "percent_of_deposits", "percent": 24 }'
{
"id": "sa_3Rm8",
"object": "set_aside",
"taxpayer_id": "tp_8Kq2",
"rule": "percent_of_deposits",
"percent": 24,
"status": "active",
"authorization": {
"type": "ach_debit",
"accepted_at": "2026-03-02T15:06:40Z"
}
}Was this page helpful?