---
title: "PayoutAccount Status updated"
method: POST
path: "payout_account.status_updated"
tags: ["Payout accounts"]
---

# PayoutAccount Status updated

`POST payout_account.status_updated` (webhook)

Sent when a payout account is status updated

Required permissions:
 - `payout:account:read`
 - `webhook_receive:payout_accounts`

## 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` PayoutAccount, required — An object representing an account used for payouts.
    - `address` object, nullable, required — The physical address associated with this payout account
      - `city` string, nullable, required — The city of the address.
      - `country` string, nullable, required — The country of the address.
      - `line1` string, nullable, required — The line 1 of the address.
      - `line2` string, nullable, required — The line 2 of the address.
      - `postal_code` string, nullable, required — The postal code of the address.
      - `state` string, nullable, required — The state of the address.
    - `business_name` string, nullable, required — The company's legal name
    - `business_representative` object, nullable, required — The business representative for this payout account
      - `date_of_birth` string, nullable, required — The date of birth of the business representative in ISO 8601 format (YYYY-MM-DD).
      - `first_name` string, nullable, required — The first name of the business representative.
      - `last_name` string, nullable, required — The last name of the business representative.
      - `middle_name` string, nullable, required — The middle name of the business representative.
    - `email` string, nullable, required — The email address of the representative
    - `id` string, required — The unique identifier for the payout account.
    - `latest_verification` object, nullable, required — The latest verification for the connected account.
      - `id` string, required — The numeric id of the verification record.
      - `last_error_code` 'abandoned' | 'consent_declined' | 'country_not_supported' | 'device_not_supported' | 'document_expired' | 'document_type_not_supported' | 'document_unverified_other' | 'email_unverified_other' | 'email_verification_declined' | 'id_number_insufficient_document_data' | 'id_number_mismatch' | 'id_number_unverified_other' | 'phone_unverified_other' | 'phone_verification_declined' | 'selfie_document_missing_photo' | 'selfie_face_mismatch' | 'selfie_manipulated' | 'selfie_unverified_other' | 'under_supported_age', required — An error code for a verification attempt.
      - `last_error_reason` string, nullable, required — A human-readable explanation of the most recent verification error. Null if no error has occurred.
      - `status` 'requires_input' | 'processing' | 'verified' | 'canceled' | 'created' | 'started' | 'submitted' | 'approved' | 'declined' | 'resubmission_requested' | 'expired' | 'abandoned' | 'review' | 'action_required' | 'manual_review', required — A status for a verification.
    - `phone` string, nullable, required — The business representative's phone
    - `status` 'connected' | 'disabled' | 'action_required' | 'pending_verification' | 'verification_failed' | 'manual_review' | 'denied' | 'not_started' | 'blocked_by_parent', required — The granular calculated statuses reflecting payout account KYC and withdrawal readiness.
  - `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_account.status_updated', 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/versions/866821546d67/schema)