---
updatedAt: 2026-09-04T00:58:11.000Z
agentTools:
  projectIndex: https://developer.drivewealth.com/apis/llms.txt
---

# Linked Bank Accounts Created

A new bank account has been linked and the event provides the details.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Events",
    "version": "2026-11-07",
    "contact": {
      "email": "producteng@drivewealth.tech"
    }
  },
  "servers": [
    {
      "url": "https://bo-api.drivewealth.io/back-office",
      "description": "Sandbox (No Real World Financial/Trading Impact)"
    },
    {
      "url": "https://bo-api.drivewealth.net/back-office",
      "description": "Production"
    }
  ],
  "security": [],
  "x-readme": {
    "explorer-enabled": false,
    "headers": [
      {
        "key": "dw-client-app-key",
        "value": "{{yourAppKey}}"
      }
    ]
  },
  "tags": [
    {
      "name": "Linked Bank Accounts"
    }
  ],
  "components": {
    "schemas": {
      "userID": {
        "type": "string",
        "example": "123e4567-e89b-12d3-a456-000000000004",
        "description": "![sensitive](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NSIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDg1IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtU0VOU0lUSVZFIiB4MT0iMCIgeTE9IjAiIHgyPSIwIiB5Mj0iMSI+PHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iI2I0NTMwOSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0iIzkyNDAwZSIvPjwvbGluZWFyR3JhZGllbnQ+PGZpbHRlciBpZD0iZ2xvdy1TRU5TSVRJVkUiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iODMiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjOTI0MDBlIiBmaWx0ZXI9InVybCgjZ2xvdy1TRU5TSVRJVkUpIiBvcGFjaXR5PSIwLjU1Ii8+PHJlY3QgeD0iMC41IiB5PSIwLjUiIHdpZHRoPSI4NCIgaGVpZ2h0PSIxOSIgcng9IjEwIiBmaWxsPSJ1cmwoI2dyYWQtU0VOU0lUSVZFKSIgc3Ryb2tlPSIjOTI0MDBlIiBzdHJva2Utd2lkdGg9IjEiLz48cGF0aCBkPSJNMTAgNC44TDE0IDYuMlYxMEMxNCAxMi43IDEyLjMgMTQuNCAxMCAxNS40QzcuNyAxNC40IDYgMTIuNyA2IDEwVjYuMloiIGZpbGw9IiNmZmZmZmYiIGZpbHRlcj0idXJsKCNnbG93LVNFTlNJVElWRSkiIG9wYWNpdHk9IjAuNSIvPjxwYXRoIGQ9Ik0xMCA0LjhMMTQgNi4yVjEwQzE0IDEyLjcgMTIuMyAxNC40IDEwIDE1LjRDNy43IDE0LjQgNiAxMi43IDYgMTBWNi4yWiIgZmlsbD0iI2ZmZmZmZiIvPjx0ZXh0IHg9IjE4IiB5PSIxMy41IiBmb250LWZhbWlseT0iSGVsdmV0aWNhLCBBcmlhbCwgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMCIgZm9udC13ZWlnaHQ9IjcwMCIgbGV0dGVyLXNwYWNpbmc9IjAuNiIgZmlsbD0iI2ZmZmZmZiI+U0VOU0lUSVZFPC90ZXh0Pjwvc3ZnPg==)\nA unique identifier created for each User on DriveWealth's platform.",
        "x-sensitive": true
      },
      "created": {
        "type": "string",
        "example": "2022-12-11T22:28:21.810Z",
        "description": ""
      },
      "updated": {
        "type": "string",
        "example": "2022-12-11T22:28:21.810Z",
        "description": ""
      },
      "bankAccountNickName": {
        "type": "string",
        "example": "PREFERRED CHECKING",
        "description": "The linked bank account nickname defined by the user."
      },
      "bankRoutingNumber": {
        "type": "string",
        "example": "123456789",
        "description": "![sensitive](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NSIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDg1IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtU0VOU0lUSVZFIiB4MT0iMCIgeTE9IjAiIHgyPSIwIiB5Mj0iMSI+PHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iI2I0NTMwOSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0iIzkyNDAwZSIvPjwvbGluZWFyR3JhZGllbnQ+PGZpbHRlciBpZD0iZ2xvdy1TRU5TSVRJVkUiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iODMiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjOTI0MDBlIiBmaWx0ZXI9InVybCgjZ2xvdy1TRU5TSVRJVkUpIiBvcGFjaXR5PSIwLjU1Ii8+PHJlY3QgeD0iMC41IiB5PSIwLjUiIHdpZHRoPSI4NCIgaGVpZ2h0PSIxOSIgcng9IjEwIiBmaWxsPSJ1cmwoI2dyYWQtU0VOU0lUSVZFKSIgc3Ryb2tlPSIjOTI0MDBlIiBzdHJva2Utd2lkdGg9IjEiLz48cGF0aCBkPSJNMTAgNC44TDE0IDYuMlYxMEMxNCAxMi43IDEyLjMgMTQuNCAxMCAxNS40QzcuNyAxNC40IDYgMTIuNyA2IDEwVjYuMloiIGZpbGw9IiNmZmZmZmYiIGZpbHRlcj0idXJsKCNnbG93LVNFTlNJVElWRSkiIG9wYWNpdHk9IjAuNSIvPjxwYXRoIGQ9Ik0xMCA0LjhMMTQgNi4yVjEwQzE0IDEyLjcgMTIuMyAxNC40IDEwIDE1LjRDNy43IDE0LjQgNiAxMi43IDYgMTBWNi4yWiIgZmlsbD0iI2ZmZmZmZiIvPjx0ZXh0IHg9IjE4IiB5PSIxMy41IiBmb250LWZhbWlseT0iSGVsdmV0aWNhLCBBcmlhbCwgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMCIgZm9udC13ZWlnaHQ9IjcwMCIgbGV0dGVyLXNwYWNpbmc9IjAuNiIgZmlsbD0iI2ZmZmZmZiI+U0VOU0lUSVZFPC90ZXh0Pjwvc3ZnPg==)\nThe routing number of the user's external bank.",
        "x-sensitive": true
      },
      "bankAccountNumberLastFour": {
        "type": "string",
        "example": "****3174",
        "description": "![sensitive](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NSIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDg1IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtU0VOU0lUSVZFIiB4MT0iMCIgeTE9IjAiIHgyPSIwIiB5Mj0iMSI+PHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iI2I0NTMwOSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0iIzkyNDAwZSIvPjwvbGluZWFyR3JhZGllbnQ+PGZpbHRlciBpZD0iZ2xvdy1TRU5TSVRJVkUiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iODMiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjOTI0MDBlIiBmaWx0ZXI9InVybCgjZ2xvdy1TRU5TSVRJVkUpIiBvcGFjaXR5PSIwLjU1Ii8+PHJlY3QgeD0iMC41IiB5PSIwLjUiIHdpZHRoPSI4NCIgaGVpZ2h0PSIxOSIgcng9IjEwIiBmaWxsPSJ1cmwoI2dyYWQtU0VOU0lUSVZFKSIgc3Ryb2tlPSIjOTI0MDBlIiBzdHJva2Utd2lkdGg9IjEiLz48cGF0aCBkPSJNMTAgNC44TDE0IDYuMlYxMEMxNCAxMi43IDEyLjMgMTQuNCAxMCAxNS40QzcuNyAxNC40IDYgMTIuNyA2IDEwVjYuMloiIGZpbGw9IiNmZmZmZmYiIGZpbHRlcj0idXJsKCNnbG93LVNFTlNJVElWRSkiIG9wYWNpdHk9IjAuNSIvPjxwYXRoIGQ9Ik0xMCA0LjhMMTQgNi4yVjEwQzE0IDEyLjcgMTIuMyAxNC40IDEwIDE1LjRDNy43IDE0LjQgNiAxMi43IDYgMTBWNi4yWiIgZmlsbD0iI2ZmZmZmZiIvPjx0ZXh0IHg9IjE4IiB5PSIxMy41IiBmb250LWZhbWlseT0iSGVsdmV0aWNhLCBBcmlhbCwgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMCIgZm9udC13ZWlnaHQ9IjcwMCIgbGV0dGVyLXNwYWNpbmc9IjAuNiIgZmlsbD0iI2ZmZmZmZiI+U0VOU0lUSVZFPC90ZXh0Pjwvc3ZnPg==)\nThe last four digits of the user's external bank account number.",
        "x-sensitive": true
      },
      "bankAccountStatus": {
        "type": "string",
        "example": "ACTIVE",
        "description": "The current status of the user's external linked bank account.",
        "enum": [
          "ACTIVE",
          "DELETED",
          "DISABLED"
        ],
        "x-enumDescriptions": {
          "ACTIVE": "The linked bank account is active.",
          "DELETED": "The linked bank account has been deleted.",
          "DISABLED": "The linked bank account has been disabled."
        }
      },
      "LinkedBankAccountEventPayload": {
        "type": "object",
        "description": "Standard link includes bankAccountNumber/bankRoutingNumber/bankAccountType; a Plaid-linked account instead has plaidProcessorToken. The real event `type` also inconsistently varies between singular `bankAccount.created` and plural `bankAccounts.created` for the same created scenario.",
        "properties": {
          "userID": {
            "$ref": "#/components/schemas/userID"
          },
          "bankAccountNickname": {
            "$ref": "#/components/schemas/bankAccountNickName"
          },
          "bankAccountNumber": {
            "$ref": "#/components/schemas/bankAccountNumberLastFour"
          },
          "bankRoutingNumber": {
            "$ref": "#/components/schemas/bankRoutingNumber"
          },
          "bankAccountType": {
            "type": "string",
            "example": "Saving"
          },
          "plaidProcessorToken": {
            "type": "string",
            "example": "processor-sandbox-123e4567-e89b-12d3-a456-00000000007d",
            "description": "Present when the bank account was linked via Plaid instead of manual entry."
          },
          "status": {
            "$ref": "#/components/schemas/bankAccountStatus"
          },
          "created": {
            "$ref": "#/components/schemas/created"
          },
          "updated": {
            "$ref": "#/components/schemas/updated"
          },
          "bankAccountDetails": {
            "type": "object",
            "description": "Present for international/travel-rule-eligible transfers — carries bank/beneficiary address details beyond the standard number/routing fields.",
            "properties": {
              "bankAddress": {
                "type": "string",
                "example": "1 Bank Plaza, Sample City, ST, 00000"
              },
              "bankCountry": {
                "type": "string",
                "example": "ARE"
              },
              "bankName": {
                "type": "string",
                "example": "Akbank"
              },
              "beneficiaryDetails": {
                "type": "object",
                "properties": {
                  "accountHolderAddress": {
                    "type": "string",
                    "example": "1 Main St Apt 2,Anytown,ST,00000"
                  },
                  "accountHolderCountry": {
                    "type": "string",
                    "example": "ARE"
                  },
                  "accountHolderName": {
                    "type": "string",
                    "example": "ABDULKADIR KARADEMIR",
                    "x-sensitive": true,
                    "description": "![sensitive](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NSIgaGVpZ2h0PSIyMCIgdmlld0JveD0iMCAwIDg1IDIwIj48ZGVmcz48bGluZWFyR3JhZGllbnQgaWQ9ImdyYWQtU0VOU0lUSVZFIiB4MT0iMCIgeTE9IjAiIHgyPSIwIiB5Mj0iMSI+PHN0b3Agb2Zmc2V0PSIwJSIgc3RvcC1jb2xvcj0iI2I0NTMwOSIvPjxzdG9wIG9mZnNldD0iMTAwJSIgc3RvcC1jb2xvcj0iIzkyNDAwZSIvPjwvbGluZWFyR3JhZGllbnQ+PGZpbHRlciBpZD0iZ2xvdy1TRU5TSVRJVkUiIHg9Ii02MCUiIHk9Ii02MCUiIHdpZHRoPSIyMjAlIiBoZWlnaHQ9IjIyMCUiPjxmZUdhdXNzaWFuQmx1ciBzdGREZXZpYXRpb249IjIuMiIvPjwvZmlsdGVyPjwvZGVmcz48cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iODMiIGhlaWdodD0iMTgiIHJ4PSI5IiBmaWxsPSIjOTI0MDBlIiBmaWx0ZXI9InVybCgjZ2xvdy1TRU5TSVRJVkUpIiBvcGFjaXR5PSIwLjU1Ii8+PHJlY3QgeD0iMC41IiB5PSIwLjUiIHdpZHRoPSI4NCIgaGVpZ2h0PSIxOSIgcng9IjEwIiBmaWxsPSJ1cmwoI2dyYWQtU0VOU0lUSVZFKSIgc3Ryb2tlPSIjOTI0MDBlIiBzdHJva2Utd2lkdGg9IjEiLz48cGF0aCBkPSJNMTAgNC44TDE0IDYuMlYxMEMxNCAxMi43IDEyLjMgMTQuNCAxMCAxNS40QzcuNyAxNC40IDYgMTIuNyA2IDEwVjYuMloiIGZpbGw9IiNmZmZmZmYiIGZpbHRlcj0idXJsKCNnbG93LVNFTlNJVElWRSkiIG9wYWNpdHk9IjAuNSIvPjxwYXRoIGQ9Ik0xMCA0LjhMMTQgNi4yVjEwQzE0IDEyLjcgMTIuMyAxNC40IDEwIDE1LjRDNy43IDE0LjQgNiAxMi43IDYgMTBWNi4yWiIgZmlsbD0iI2ZmZmZmZiIvPjx0ZXh0IHg9IjE4IiB5PSIxMy41IiBmb250LWZhbWlseT0iSGVsdmV0aWNhLCBBcmlhbCwgc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMCIgZm9udC13ZWlnaHQ9IjcwMCIgbGV0dGVyLXNwYWNpbmc9IjAuNiIgZmlsbD0iI2ZmZmZmZiI+U0VOU0lUSVZFPC90ZXh0Pjwvc3ZnPg==)"
                  }
                }
              },
              "default": {
                "type": "boolean",
                "example": false
              }
            }
          },
          "bankAccountPurpose": {
            "type": "string",
            "example": "TRAVEL_RULE"
          }
        }
      },
      "LinkedBankAccountCreatedEvent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "event_123e4567-e89b-12d3-a456-00000000007c"
          },
          "type": {
            "type": "string",
            "enum": [
              "bankAccounts.created"
            ],
            "x-enumDescriptions": {
              "bankAccounts.created": "Identifies this as a linked-bank-account-created event."
            }
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "example": "2026-07-23T07:08:14.121518146Z"
          },
          "payload": {
            "$ref": "#/components/schemas/LinkedBankAccountEventPayload"
          }
        }
      }
    }
  },
  "webhooks": {
    "bankAccounts.created": {
      "post": {
        "summary": "Linked Bank Accounts Created",
        "operationId": "bankAccountsCreatedEvent",
        "tags": [
          "Linked Bank Accounts"
        ],
        "description": "A new bank account has been linked and the event provides the details.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinkedBankAccountCreatedEvent"
              },
              "example": {
                "id": "event_123e4567-e89b-12d3-a456-00000000007c",
                "type": "bankAccounts.created",
                "timestamp": "2026-07-23T07:08:14.121518146Z",
                "payload": {
                  "userID": "123e4567-e89b-12d3-a456-000000000004",
                  "bankAccountNickname": "PREFERRED CHECKING",
                  "bankAccountNumber": "****3174",
                  "bankRoutingNumber": "123456789",
                  "bankAccountType": "Saving",
                  "plaidProcessorToken": "processor-sandbox-123e4567-e89b-12d3-a456-00000000007d",
                  "status": "ACTIVE",
                  "created": "2026-08-11T22:28:21.810Z",
                  "updated": "2026-08-11T22:28:21.810Z",
                  "bankAccountDetails": {
                    "bankAddress": "1 Bank Plaza, Sample City, ST, 00000",
                    "bankCountry": "ARE",
                    "bankName": "Example International Bank",
                    "beneficiaryDetails": {
                      "accountHolderAddress": "1 Main St Apt 2,Anytown,ST,00000",
                      "accountHolderCountry": "ARE",
                      "accountHolderName": "JOHN SAMPLE DOE"
                    },
                    "default": false
                  },
                  "bankAccountPurpose": "TRAVEL_RULE"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Event received"
          }
        }
      }
    }
  }
}
```

# Sibling pages

* [Linked Bank Accounts Deleted](https://developer.drivewealth.com/apis/reference/bankaccountsdeletedevent.md)
* [Linked Bank Accounts Updated](https://developer.drivewealth.com/apis/reference/bankaccountsupdatedevent.md)