> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Payout

> Send money to a beneficiary's payout destination

<Note>
  This endpoint requires an `Idempotency-Key` header to prevent duplicate payouts.
</Note>

## Path Parameters

<ParamField path="account_id" type="string" required>
  The account's external ID (starts with `acc_`)
</ParamField>

## Headers

<ParamField header="Idempotency-Key" type="string" required>
  Unique key to prevent duplicate payouts (e.g., UUID v4)
</ParamField>

## Request Body

<ParamField body="beneficiary_id" type="string" required>
  Beneficiary external ID (starts with `bene_`)
</ParamField>

<ParamField body="payout_destination_id" type="string" required>
  Payout destination external ID (starts with `dest_`)
</ParamField>

<ParamField body="amount" type="string" required>
  Payout amount (decimal string, must be positive)
</ParamField>

<ParamField body="currency" type="string" required>
  ISO 4217 currency code
</ParamField>

<ParamField body="note" type="string">
  Optional internal note (max 500 characters)
</ParamField>

## Response

<ResponseField name="id" type="string">
  Payout identifier (starts with `po_`)
</ResponseField>

<ResponseField name="object" type="string">
  Always returns `"payout"`
</ResponseField>

<ResponseField name="account_id" type="string">
  Account ID
</ResponseField>

<ResponseField name="beneficiary_id" type="string">
  Beneficiary ID
</ResponseField>

<ResponseField name="payout_destination_id" type="string">
  Payout destination ID
</ResponseField>

<ResponseField name="amount" type="string">
  Payout amount (decimal)
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code
</ResponseField>

<ResponseField name="amount_in_usd" type="string">
  Amount converted to USD
</ResponseField>

<ResponseField name="status" type="string">
  Payout status: `pending_approval`, `pending`, `processing`, `completed`, or `failed`
</ResponseField>

<ResponseField name="provider" type="string">
  Payment provider (null until submitted)
</ResponseField>

<ResponseField name="provider_reference_id" type="string">
  Provider reference ID
</ResponseField>

<ResponseField name="initiated_at" type="string">
  ISO 8601 timestamp when payout was initiated
</ResponseField>

<ResponseField name="submitted_at" type="string">
  ISO 8601 timestamp when payout was submitted to provider
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO 8601 timestamp when payout completed
</ResponseField>

<ResponseField name="failed_at" type="string">
  ISO 8601 timestamp when payout failed
</ResponseField>

<ResponseField name="failed_reason" type="string">
  Reason for failure
</ResponseField>

<ResponseField name="note" type="string">
  Optional note
</ResponseField>

<ResponseField name="created" type="string">
  ISO 8601 timestamp when created
</ResponseField>

<ResponseField name="updated" type="string">
  ISO 8601 timestamp when last updated
</ResponseField>

## Response Example

```json theme={null}
{
  "id": "po_1234567890abcdef",
  "object": "payout",
  "account_id": "acc_1234567890abcdef",
  "beneficiary_id": "bene_1234567890abcdef",
  "payout_destination_id": "dest_1234567890abcdef",
  "amount": "100.00",
  "currency": "USD",
  "amount_in_usd": "100.00",
  "status": "pending_approval",
  "provider": null,
  "provider_reference_id": null,
  "initiated_at": "2024-01-15T10:00:00Z",
  "submitted_at": null,
  "completed_at": null,
  "failed_at": null,
  "failed_reason": null,
  "note": "Monthly payment",
  "created": "2024-01-15T10:00:00Z",
  "updated": "2024-01-15T10:00:00Z"
}
```