---
title: "Rename Saved Payout Method"
method: PATCH
path: "/payouts/methods/{payout_method_id}"
tags: ["Payouts"]
---

# Rename Saved Payout Method

`PATCH /payouts/methods/{payout_method_id}`

Changes the label used to identify a saved payout method.

## Request body

- object
  - `nickname` string, required — New label for the payout method.

## Response `200`

payout method renamed

- object
  - `account_reference` string, nullable, required — Masked identifier for the destination.
  - `account_validation_status` 'MATCH' | 'CLOSE_MATCH' | 'NO_MATCH' | 'UNSUPPORTED' | 'PROCESSING' | 'null', nullable, required — The bank's answer to whether this account belongs to the payout account holder, checked once when the account is linked. `null` if the account has not been checked.
  - `created_at` string, date-time, required
  - `destination_currency` string, required
  - `estimated_arrival` object, nullable, required — `null` after an update. List payout methods to retrieve arrival estimates.
  - `fee_structure` object, nullable, required — `null` after an update. List payout methods to retrieve the configured fee terms.
  - `id` string, required — Payout method ID, prefixed `potk_`.
  - `institution_name` string, nullable, required
  - `is_default` boolean, required
  - `nickname` string, nullable, required — User-defined label for the payout method.
  - `object` 'payout_method', required
  - `payer_name` string, nullable, required
  - `quote` object, nullable, required — Always `null` after an update.
  - `status` 'created' | 'active' | 'broken', required
  - `supported_payout_method` object, nullable, required
    - `delivery_type` 'cash_pickup' | 'bank_deposit' | 'home_delivery' | 'mobile_wallet' | 'masspay_card' | 'paper_check' | 'bill' | 'cryptocurrency' | 'unknown', required — How funds are delivered.
    - `icon_url` string, nullable, required
    - `name` string, nullable, required
    - `supports_instant_delivery` boolean, required
    - `supports_standard_delivery` boolean, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

## Changes

- **2026-08-04** `ca841fbd6786` — 1 info
  - added the required property `account_validation_status` to the response with the `200` status
- **2026-08-04** `bdd0e2c70d58` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/payouts/methods/:payout_method_id/patch.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/ca841fbd6786/schema)