MOmonta
Teams

Switch automatic withdrawal on or off for up to 50 teams

Changed on

Switch automatic bank withdrawal on (enabled: true) or off (enabled: false) for up to 50 teams in one call, the bulk form of autoWithdraw on PATCH /teams/{id}. Page through larger lists in several requests.</br></br>Partial success: each team is changed on its own and gets one entry in results, in request order, so a batch with mixed results still returns 200. Check result for each team: for example no-bank-account means the team was switched on but is not paid until it adds a bank account, and ineligible comes with a reason.</br></br>Safe to repeat: a team that is already on keeps its next withdrawal date (already-on), and a team that is already off is left alone (already-off).</br></br>Scope: if any id does not exist or belongs to a team outside your operator's scope, the whole request is refused with 403 TEAMS_NOT_IN_OPERATOR_SCOPE and context.teamIds lists those ids. Nothing is changed in that case.</br></br>A call can take up to about 30 seconds for 50 teams. Run these calls one after another: requests over the per-consumer concurrency cap get 429 CONCURRENCY_LIMIT_EXCEEDED.</br></br>Required scope: teams:write </br>Organization authorization: supported

post/api/v1/teams/auto-withdrawal/bulk

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/teams/auto-withdrawal/bulk
  • Auth
    HTTP bearer

Request body

teamIdsinteger[] required

Ids of the teams to switch automatic withdrawal on or off for: between 1 and 50 distinct, positive ids. Page through larger lists in several requests.

enabledboolean required

true switches automatic withdrawal on for every listed team, false switches it off.

Example request

{
  "teamIds": [
    266672,
    266673,
    266674
  ],
  "enabled": true
}

Response

One result per requested team

Example response

{
  "summary": {
    "requested": 4,
    "enabled": 1,
    "alreadyOn": 1,
    "ineligible": 1,
    "failed": 1
  },
  "results": [
    {
      "teamId": 266672,
      "autoWithdrawNextAt": "2026-11-01T00:00:00Z"
    }
  ]
}

Changes