# Account Event

## Account Event

Guru Pay sends an Account Webhook when an account changes state in the system. This allows your application to listent to account events like when a new account is created or closed.

## Virtual IBANs

Currently Guru Pay application will send account events only to customers who are using Virtual IBAN product.

With the later system updates, after public communication account webhooks will be enabled for all customers.

### When It's Triggered <a href="#when-its-triggered" id="when-its-triggered"></a>

This webhook is triggered when:

* A new Virtual IBAN is opened for a customer
* Virtual IBAN is closed
* The webhook configuration is active for the recipient account.

### Event Structure <a href="#event-structure" id="event-structure"></a>

```json
{
  "type": "account",
  "event": "account.created",
  "created_at": 1757604022,
  "account": {
    "uuid": "7c004b54-3f62-4cb0-8ee1-16fc436ba39d",
    "status": "created",
    "customer_uuid": "6fe8a48e-82a1-4410-a18f-b2686b77f6d7",
    "account_name": "Account name",
    "account_number": "LT383400015000111111",
    "currency": "EUR",
    "opening_date": "2025-09-11",
    "opening_date_unix": 1757548800,
    "balance": 0,
    "balance_national": 0,
    "book_balance": 0,
    "book_balance_national": 0,
    "available_balance": 0,
    "available_balance_national": 0,
    "hold": 0,
    "cards_reserved_amount": 0,
    "cards_reserved_amount_national": 0,
    "created_at": 1757604019,
    "updated_at": 1757604019,
    "account_type": "virtual",
    "virtual_account_holder": {
      "name": "Virtual IBAN holder name",
      "person_type": "natural|legal",
      "citizenship": "LT",
      "registrationCode": "12345",
      "address": {
        "line": "Address line",
        "city": "Vilnius",
        "country": "LT",
        "postalCode": "111222"
      }
    }
  }
}
```

### Event Types <a href="#event-types" id="event-types"></a>

| Type            | Description                               |
| --------------- | ----------------------------------------- |
| account.created | New account was created and IBAN assigned |
| account.closed  | Account was closed                        |