Currency Account

Webhook events will be triggered whenever a currency account is created or its status is updated.

Event Category:

MULTI_CURRENCY_ACCOUNT

Event Type:

MULTI_CURRENCY_ACCOUNT.CURRENCY_ACCOUNT.CREATE
MULTI_CURRENCY_ACCOUNT.CURRENCY_ACCOUNT.UPDATE

Example webhook event

The data object is expected to have the same structure as the response from the Retrieve a Currency Account endpoint.

{
  eventId: 'evt_195715046e51f58d',
  eventCategory: 'MULTI_CURRENCY_ACCOUNT',
  eventType: 'MULTI_CURRENCY_ACCOUNT.CURRENCY_ACCOUNT.UPDATE',
  eventAction: 'UPDATE',
  data: {
    id: '70709221-f6cc-4a5d-a038-efcfdad538ba',
    iban: '',
    status: 'AVAILABLE',
    userId: '42c784f4-eb84-4e87-b0de-8c2183aed67c',
    purpose: '03',
    bankCity: 'Sandbox City',
    bankCode: '006',
    bankName: 'Citibank',
    currency: 'USD',
    sortCode: '',
    createdAt: '2025-03-07T15:53:33.505124+00:00',
    swiftCode: 'GEOORUMMXXX',
    updatedAt: '2025-03-07T15:54:00.859+00:00',
    accountType: 'CHECKING',
    bankAddress: '123 Example Street, Sandbox City, Testland, 98765, Country',
    bankCountry: 'USA',
    branchNumber: '01',
    failedReason: null,
    accountNumber: '73380000000363268',
    routingNumber: '031100209',
    bankPostalCode: '98765',
    accountHolderName: 'John Doe'
  },
  createdAt: '2025-03-07T15:54:01.420Z',
  timestamp: '2025-03-07T15:54:20.357Z',
  version: 'v2'
}