---
title: "Account events"
---
Account events notify you when an account finishes setting up and becomes active. When you [create an account](/platform/accounts/create-an-account), it can start in a `pending` status while Gravv sets up its wallet and virtual account. This event tells you when it's ready to use.

## Account event types

Gravv sends a single account event type, `account.activated`. It represents an account that finished setting up and is ready to use.

## When account events are sent

Gravv sends an account event when a `pending` account finishes setting up and moves to `active`. After this event, the account can send and receive funds.

## Account event structure

The `event_data` object for account events contains the following fields:

| Field          | Type   | Description                              |
| :------------- | :----- | :--------------------------------------- |
| account_id     | string | the account that became active           |
| customer_id    | string | the customer the account belongs to      |
| status         | string | the account status, `active`             |
| currency       | string | the account currency                     |
| bank_details   | object | the virtual account's bank details       |
| wallet_details | object | the account's wallet address and network |
| created_at     | string | when the account was activated           |

The `bank_details` object has the following fields:

| Field               | Type   | Description                        |
| :------------------ | :----- | :--------------------------------- |
| bank_name           | string | name of the virtual account's bank |
| account_name        | string | beneficiary name on the account    |
| account_number      | string | virtual account number             |
| routing_number      | string | routing number                     |
| bank_address        | string | bank address                       |
| beneficiary_address | string | beneficiary address                |

The `wallet_details` object has the following fields:

| Field   | Type   | Description                          |
| :------ | :----- | :----------------------------------- |
| address | string | the account's wallet address         |
| network | string | the blockchain network of the wallet |

The following is a sample payload for an account event:

```json title="sample account event payload"
{
  "event_id": "841baba3-b0a5-415e-ac2f-e4ea99491f55",
  "tenant_id": "31a6fc8d-826c-496c-9e32-7396aed013d2",
  "timestamp": "2026-06-23T03:46:16.993972033Z",
  "event_data": {
    "account_id": "a4d83e55-435e-41c9-9a0b-dcb99f690c95",
    "customer_id": "d12ded01-9081-4a3c-a76c-70654f0a0175",
    "status": "active",
    "currency": "USD",
    "bank_details": {
      "bank_name": "Example Bank",
      "account_name": "Jane Doe",
      "account_number": "900300758080",
      "routing_number": "101019644",
      "bank_address": "1800 North Pole St., Orlando, FL 32801",
      "beneficiary_address": "201 Allen St, New York, NY 10002, US"
    },
    "wallet_details": {
      "address": "0xf73bdd069dc31aa8f334b177b175936ba98237a2",
      "network": "polygon"
    },
    "created_at": "2026-06-23T03:46:16.993972033Z"
  },
  "event_type": "account.activated",
  "event_category": "account",
  "event_group_id": "a4d83e55-435e-41c9-9a0b-dcb99f690c95"
}
```

For the required fields in all Gravv webhook payloads, see [Webhook payload structure](/platform/webhooks/webhooks-overview#webhook-payload-structure).