---
title: "PayoutMethod Created"
method: POST
path: "payout_method.created"
tags: ["Payouts"]
---

# PayoutMethod Created

`POST payout_method.created` (webhook)

Sent when a payout method is created

Required permissions:
 - `payout:destination:read`
 - `webhook_receive:payout_methods`

## Headers

- `webhook-id` string, required — A unique identifier for this webhook request
- `webhook-signature` string, required — The signature of the webhook request with the webhook version prepended
- `webhook-timestamp` string, required — The timestamp in seconds since the Unix epoch that the webhook was sent at on the server

## Payload

- object
  - `api_version` 'v1', required — The API version for this webhook
  - `api_version_date` string, nullable, required — The dated API version (Api-Version-Date) the payload is serialized to
  - `company_id` string, nullable — The account ID that this webhook event is associated with
  - `data` object, required
    - `account_reference` string, nullable, required — Masked identifier for the destination, such as the last four digits of a bank account.
    - `bank_verification_state` 'checking' | 'verified' | 'no_data' | 'warning' | 'broken' | 'null', nullable, required — Lifecycle trust state: `checking` (verification still running), `verified` (bank confirmed ownership or a payout already completed to it), `no_data` (verification unavailable or bank returned no ownership data), `warning` (bank could not confirm the destination's owner), `broken` (payouts failed with a permanent account error), `null` (never checked).
    - `created_at` string, date-time, required — When the payout method was added.
    - `destination_currency` string, required — Currency payouts are delivered in for this method.
    - `estimated_arrival` object, nullable, required — Estimated arrival times before an amount-specific quote is requested. Null when the method is not currently eligible.
      - `instant` string, date-time, nullable, required — Estimated instant-delivery arrival, or null when unavailable.
      - `standard` string, date-time, nullable, required — Estimated standard-delivery arrival, or null when unavailable.
    - `fee_structure` object, nullable, required — Configured fee terms for this payout method. Null when the method is not currently eligible. An amount-specific quote remains authoritative.
      - `currency` string, required — Currency code of fixed_amount.
      - `fixed_amount` number, float, required — Fixed fee charged, denominated in `currency`.
      - `percentage` number, float, required — Percentage of the withdrawal amount charged as a fee.
    - `id` string, required — Payout method ID.
    - `institution_name` string, nullable, required — Name of the bank or institution receiving payouts.
    - `is_clone` boolean, required — Whether this method is a copy of one saved on another of the payer's accounts.
    - `is_default` boolean, required — Whether this is the default payout method for the account.
    - `linked_via_plaid` boolean, required — Whether the payer added this method by signing in to their bank rather than typing account details.
    - `needs_plaid_reconnect` boolean, required — Whether the bank sign-in behind this method has expired and must be redone before it counts as linked.
    - `nickname` string, nullable, required — User-defined label for the payout method.
    - `object` 'payout_method', required
    - `payer_name` string, nullable, required — Display name of the payout rail, such as `ACH Bank Deposit`.
    - `quote` object, nullable, required — Fee and delivery estimate for withdrawing the requested amount through this method. Null unless an amount was provided, or when the estimate is unavailable.
      - `amount` number, float, required — The withdrawal amount the quote is for.
      - `currency` string, required — Currency of the quoted amount.
      - `exchange_rate` number, float, required — Exchange rate from the withdrawal currency to the destination currency.
      - `instant` object, nullable, required — Instant-delivery estimate. Null if the method does not support instant delivery, instant delivery is unavailable for the account, or the amount does not cover the fee.
        - `fee` number, float, required — Total fee charged, in the withdrawal currency.
        - `total_received` number, float, required — Amount delivered after fees, in the withdrawal currency.
      - `max_limit` number, float, nullable, required — Maximum withdrawal amount for this method, in the withdrawal currency.
      - `min_limit` number, float, required — Minimum withdrawal amount for this method, in the withdrawal currency.
      - `standard` object, nullable, required — Standard-delivery estimate. Null if the method does not support standard delivery, or the amount does not cover the fee.
        - `fee` number, float, required — Total fee charged, in the withdrawal currency.
        - `total_received` number, float, required — Amount delivered after fees, in the withdrawal currency.
    - `status` 'created' | 'active' | 'broken', required — Lifecycle status: `created` means saved but unused, `active` means a payout succeeded through it, `broken` means the last payout failed.
    - `supported_payout_method` object, nullable, required — The supported payout method this saved method was created from.
      - `country_code` string, nullable, required — ISO 3166-1 alpha-3 country the destination pays out to.
      - `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 — Supported payout method icon URL.
      - `name` string, nullable, required — Supported payout method display name.
      - `supports_instant_delivery` boolean, required
      - `supports_plaid` boolean, required — Whether the payer can link this method by signing in to their bank instead of typing account details.
      - `supports_standard_delivery` boolean, required
    - `unavailable_reason` 'destination_retired' | 'null', nullable, required — Why this method is unavailable: `destination_retired` means the payout provider stopped offering the destination. Whop may automatically remap an eligible method that was not linked through Plaid to a compatible replacement; otherwise, the account owner must re-add it. `null` means no unavailability reason is known.
  - `id` string, required — A unique ID for every single webhook request
  - `timestamp` string, date-time, required — The timestamp in ISO 8601 format that the webhook was sent at on the server
  - `type` 'payout_method.created', required — The webhook event type

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

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