---
title: "Create Payout Method"
method: POST
path: "/payouts/methods"
tags: ["Payouts"]
---

# Create Payout Method

`POST /payouts/methods`

Saves a new payout method for an account or user by submitting the destination's required fields, keyed by field id (list them with GET /payouts/methods?destination_id=...). Sensitive values are vaulted in transit and never stored raw; a Basis Theory token id may be passed in place of a raw value. The created method is immediately usable as payout_method_id on POST /payouts. A field validation failure returns the destination's full required_fields schema alongside the error.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `account_id` string — The account to add the payout method for (a biz_ identifier). Provide this or user_id.
  - `destination_currency` string — Currency the destination delivers payouts in.
  - `destination_id` string, required — The payout destination to add (a pd_ identifier from a previous listing).
  - `fields` object, required — The destination's required field values, keyed by field id.
  - `is_default` boolean — Whether to make this the account's default payout method.
  - `nickname` string, required — A label for the payout method, unique per destination.
  - `user_id` string — The user to add the payout method for (a user_ identifier). Provide this or account_id.

## Response `201`

a pre-tokenized Basis Theory value passes through unvaulted

- object
  - `account_reference` string, nullable, required — Masked identifier for the destination.
  - `created_at` string, date-time, required
  - `destination_currency` string, required
  - `id` string, required — Payout method ID, usable as payout_method_id on POST /payouts.
  - `institution_name` string, nullable, required
  - `is_default` boolean, required
  - `nickname` string, nullable, required
  - `object` 'payout_method', required
  - `payer_name` string, nullable, required
  - `payout_destination` object, nullable, required
    - `delivery_type` string, required
    - `icon_url` string, nullable, required
    - `name` string, nullable, required
    - `supports_instant_delivery` boolean, required
    - `supports_standard_delivery` boolean, required
  - `quote` object, nullable, required — Always null on create.
  - `status` 'created' | 'active' | 'broken', required

## Other responses

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

## Changes

- **2026-07-26** `60bbb4a6ffbc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/payouts/methods/post.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/60bbb4a6ffbc/schema)