---
title: "CreateBankAccountRequest"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/CreateBankAccountRequest"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# CreateBankAccountRequest

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    BankAccountType:
      title: BankAccountType
      type: string
      description: The type of bank account
      enum:
        - SAVINGS
        - CHECKING
      example: CHECKING
    CreateBankAccountRequest:
      title: CreateBankAccountRequest
      type: object
      required:
        - type
        - holderName
        - number
        - routingNumber
        - bankName
      properties:
        type:
          $ref: "#/components/schemas/BankAccountType"
        holderName:
          type: string
          description: Name of the account holder
          example: Jane Doe
        number:
          type: string
          description: Bank account number (4-17 characters)
          minLength: 4
          maxLength: 17
          example: "1234567890"
        routingNumber:
          type: string
          description: Bank routing number (exactly 9 digits)
          minLength: 9
          maxLength: 9
          example: "021000021"
        bankName:
          type: string
          description: Name of the bank
          example: Chase Bank
        nickname:
          type: string
          description: Optional nickname for the bank account
          example: Main
        primaryAccount:
          type: boolean
          nullable: true
          description: >
            Whether this should become the owner's primary bank account. Setting
            `true` demotes any existing primary for the same owner. Defaults to
            `false` (the owner's first bank account always becomes primary
            regardless of this value). `null` is treated the same as omitted.
          default: false
          example: false
```