---
title: "Updates recurring payouts."
method: POST
path: "/v1/groups/{groupId}/payouts/recurring"
tags: ["Groups"]
---

# Updates recurring payouts.

`POST /v1/groups/{groupId}/payouts/recurring`

This endpoint will remove any recipients not sent in the request.
If a recipient in the request is not a valid member in the group they will not be added to the recurring payouts.

## Path parameters

- `groupId` integer, required

## Request body

- RobloxGroupsApiPayoutRequest — Multi-payout request information.
  - `PayoutType` 1 | 2 — The Roblox.Groups.Api.PayoutType. ['FixedAmount' = 1, 'Percentage' = 2]
  - `Recipients` RobloxGroupsApiPayoutRecipientRequest[] — The recipients of the payouts.
    - `recipientId` integer — The recipient id.
    - `recipientType` 0 | 1 — The recipient type. ['User' = 0, 'Group' = 1]
    - `amount` integer — The amount to payout.
  - `IdempotencyKey` string — The idempotency key of the payout request.
  - `WatermarkContributions` RobloxGroupsApiWatermarkContributionRequest[] — Optional watermark contributions for DevEx attribution tracking.
    - `balanceKey` 'Standard' | 'O18Boosted' — ['Standard' = 1, 'O18Boosted' = 2]
    - `amount` integer

## Response `200`

OK

- RobloxWebWebAPIApiEmptyResponseModel

## Other responses

- `400` — 1: Group is invalid or does not exist. 24: Invalid payout type. 25: The amount is invalid. 26: Too many recipients. 27: The recipients are invalid.
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 12: Insufficient Robux funds. 28: Group has paid out too recently. Please wait and try again. 35: 2-Step Verification is required to make further transactions. Go to Settings > Security to complete 2-Step Verification.
- `503` — 22: The feature is disabled.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)