Inflow events

Inflow events notify you when funds arrive in accounts in real time.

When inflow events are sent

Gravv sends an inflow event when the transaction is confirmed, and funds are credited to the account balance.

Inflow event structure

The event_data object for inflow events contains the following fields:

Field	Type	Description
amount	string	amount of funds received
remark	string	transaction description
source	object	details about where the funds came from
destination	object	destination of where the funds are going
client_reference	string	optional reference identifier, which is null for inflows

The following is a sample payload for an inflow event:

{
  "event_id": "841baba3-b0a5-415e-ac2f-e4ea99491f55",
  "tenant_id": "31a6fc8d-826c-496c-9e32-7396aed013d2",
  "timestamp": "2025-11-15T03:46:16.993972033Z",
  "event_data": {
    "amount": "10",
    "remark": "Account Funding",
    "source": {
      "id": "fd84a244-dc5a-4232-af7d-f2047bf59542",
      "source_type": "internal_account"
    },
    "destination": {
      "id": null,
      "rail": null,
      "destination_type": null,
    },
    "client_reference": null
  },
  "event_type": "inflow.completed",
  "event_category": "inflow",
  "event_group_id": "5e1fc3b7-6c73-429d-8919-cb398983cc94"
}

The source object contains the following fields:

Field	Type	Description
id	string	identifier for the source account
source_type	string	type of source, for example, internal_account

For the required fields in all Gravv webhook payloads, see Webhook payload structure.