Account events

Account events notify you when an account finishes setting up and becomes active. When you 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:

{
  "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.