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

> ## Agent Instructions
> Treat the published Augustus OpenAPI specification (https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers.
> Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required.
> Cite or link the relevant docs.augustus.com page when answering integration questions.
> Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation.
> Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key.
> The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions.

# user_payout.initiated

> A customer payout has been initiated



## OpenAPI

````yaml https://api.getivy.de/openapi/webhooks/json post /api/service/webhook-event/user_payout.initiated
openapi: 3.0.0
info:
  title: Ivy Webhook Events
  description: Ivy Webhook Events schema
  version: '1.0'
  contact:
    name: Ivy
    url: https://www.getivy.io
    email: help@getivy.io
servers: []
security: []
tags: []
paths:
  /api/service/webhook-event/user_payout.initiated:
    post:
      tags:
        - WebhookEventExamples
        - Deprecated
      summary: user_payout.initiated
      description: A customer payout has been initiated
      operationId: WebhookEventExamplesController_userPayoutInitiated
      parameters: []
      requestBody:
        required: true
        description: Data of the webhook event
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserPayoutInitiatedWebhookEventDto'
      responses:
        '200':
          description: OK
      deprecated: true
      servers:
        - url: https://{yourDomain}
          variables:
            yourDomain:
              description: The URL where you want to receive webhook events
              default: www.your-domain.com
components:
  schemas:
    UserPayoutInitiatedWebhookEventDto:
      type: object
      properties:
        id:
          description: The unique id for the webhook.
          type: string
        type:
          type: string
          enum:
            - user_payout.initiated
        date:
          description: The date of the webhook.
          type: string
        payload:
          description: The initiated user payout data.
          type: object
          properties:
            id:
              description: The payout ID
              type: string
            type:
              description: The payout type
              type: string
              enum:
                - beneficiary
                - customer
            destination:
              description: The payout destination
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - iban
                    - sort_code
                    - bank_code
                    - bban
                    - wallet
                    - aba
                  x-enumNames:
                    - IBAN
                    - SORT_CODE
                    - BANK_CODE
                    - BBAN
                    - WALLET
                    - ABA
                iban:
                  type: object
                  properties:
                    accountHolderName:
                      type: string
                      minLength: 1
                    iban:
                      type: string
                    bic:
                      type: string
                  required:
                    - accountHolderName
                    - iban
                aba:
                  type: object
                  properties:
                    accountHolderName:
                      type: string
                      minLength: 1
                    routingNumber:
                      type: string
                      pattern: ^[0-9]+$
                    accountNumber:
                      type: string
                      pattern: ^[0-9]+$
                  required:
                    - accountHolderName
                    - routingNumber
                    - accountNumber
                sortCode:
                  type: object
                  properties:
                    accountHolderName:
                      type: string
                      minLength: 1
                    sortCode:
                      type: string
                      pattern: ^[0-9]+$
                    accountNumber:
                      type: string
                      pattern: ^[0-9]+$
                      maxLength: 8
                  required:
                    - accountHolderName
                    - sortCode
                    - accountNumber
                bankCode:
                  type: object
                  properties:
                    accountHolderName:
                      type: string
                      minLength: 1
                    code:
                      type: string
                    accountNumber:
                      type: string
                  required:
                    - accountHolderName
                    - code
                    - accountNumber
                bban:
                  type: object
                  properties:
                    accountHolderName:
                      type: string
                      minLength: 1
                    bban:
                      type: string
                    bic:
                      type: string
                  required:
                    - accountHolderName
                    - bban
                wallet:
                  type: object
                  properties:
                    address:
                      description: The blockchain wallet address
                      type: string
                    blockchain:
                      description: The blockchain network
                      type: string
                      enum:
                        - BTC
                        - BTC-TESTNET4
                        - ETH
                        - ETH-SEPOLIA
                        - SOL
                        - SOL-DEVNET
                        - MATIC
                        - MATIC-AMOY
                  required:
                    - address
                    - blockchain
              required:
                - type
            status:
              description: The payout status
              type: string
              enum:
                - paid
                - pending
                - in_transit
                - failed
                - canceled
              x-enumNames:
                - Paid
                - Pending
                - InTransit
                - Failed
                - Canceled
            amount:
              description: The payout amount
              type: number
            currency:
              description: The payout currency
              type: string
              enum:
                - EUR
                - GBP
                - USDC
                - USD
            metadata:
              description: The payout metadata
              type: object
              additionalProperties: {}
            createdAt:
              description: The payout created at
            updatedAt:
              description: The payout updated at
            paymentReference:
              description: The payout payment reference
              type: string
            transactionId:
              description: The payout transaction ID
              type: string
            failure:
              description: Failure details. Only available if the payout failed.
              type: object
              properties:
                code:
                  description: >-
                    Failure code. Please refer to the documentation for the list
                    of possible values.
                  type: string
                  enum:
                    - account_closed
                    - account_blocked
                    - insufficient_funds
                    - invalid_account_format
                    - invalid_instruction
                    - invalid_amount
                    - invalid_time
                    - duplicate_transaction
                    - payee_verification_failed
                    - system_error
                    - provider_system_error
                    - rejected_by_correspondent_bank
                    - blocked_by_review
                    - unknown
                  x-enumNames:
                    - ACCOUNT_CLOSED
                    - ACCOUNT_BLOCKED
                    - INSUFFICIENT_FUNDS
                    - INVALID_ACCOUNT_FORMAT
                    - INVALID_INSTRUCTION
                    - INVALID_AMOUNT
                    - INVALID_TIME
                    - DUPLICATE_TRANSACTION
                    - PAYEE_VERIFICATION_FAILED
                    - SYSTEM_ERROR
                    - PROVIDER_SYSTEM_ERROR
                    - REJECTED_BY_CORRESPONDENT_BANK
                    - BLOCKED_BY_REVIEW
                    - UNKNOWN
                message:
                  description: Human readable description of the failure.
                  type: string
                retry:
                  description: If true, you can safely retry.
                  type: boolean
              required:
                - code
                - message
                - retry
          required:
            - id
            - type
            - destination
            - status
            - amount
            - currency
            - createdAt
            - updatedAt
      required:
        - id
        - type
        - date
        - payload

````